home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / virus / tbav609.zip / TBAV.DOC < prev    next >
Text File  |  1993-12-06  |  309KB  |  7,606 lines
  1.  
  2. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                  CONTENTS
  3.  
  4.  
  5.  
  6.      SECTION 0. INTRODUCTION
  7.           1. How to use the manual . . . . . . . . . . . . . . . . .     0 - 1
  8.           2. Overview of the TBAV utilities  . . . . . . . . . . . .     0 - 1
  9.  
  10.      SECTION I. INSTALLING TBAV
  11.           1. How to install TBAV   . . . . . . . . . . . . . . . . .     I - 1
  12.                1.1 Initial installation  . . . . . . . . . . . . . .     I - 1
  13.                1.2 Windows . . . . . . . . . . . . . . . . . . . . .     I - 4
  14.           2. Configuration . . . . . . . . . . . . . . . . . . . . .     I - 6
  15.           3. TbSetup . . . . . . . . . . . . . . . . . . . . . . . .     I - 8
  16.                3.1. The Purpose of TbSetup . . . . . . . . . . . . .     I - 8
  17.                3.2. How to use TbSetup . . . . . . . . . . . . . . .     I - 8
  18.                3.3. Command line options . . . . . . . . . . . . . .    I - 13
  19.                3.4. While executing  . . . . . . . . . . . . . . . .    I - 15
  20.           4. TbDriver  . . . . . . . . . . . . . . . . . . . . . . .    I - 18
  21.                4.1. Purpose of TbDriver  . . . . . . . . . . . . . .    I - 18
  22.                4.2. Command line options . . . . . . . . . . . . . .    I - 18
  23.                4.3. Language support . . . . . . . . . . . . . . . .    I - 20
  24.           5. System maintenance  . . . . . . . . . . . . . . . . . .    I - 21
  25.           6. Network maintenance . . . . . . . . . . . . . . . . . .    I - 23
  26.                6.1. Using DOS REPLACE  . . . . . . . . . . . . . . .    I - 23
  27.                6.2. Using PkUnZip  . . . . . . . . . . . . . . . . .    I - 23
  28.  
  29.      SECTION II. ANTI-VIRUS STRATEGY
  30.           1. Protection against viruses  . . . . . . . . . . . . . .    II - 1
  31.                1.1. Introduction . . . . . . . . . . . . . . . . . .    II - 1
  32.                1.2. Basic precautions  . . . . . . . . . . . . . . .    II - 1
  33.           2. What to do when a virus strikes . . . . . . . . . . . .    II - 6
  34.                2.1. Detection of viruses . . . . . . . . . . . . . .    II - 6
  35.                2.2. Recovering from viruses  . . . . . . . . . . . .    II - 7
  36.  
  37.      SECTION III. USING THE TBAV UTILITIES
  38.           1. TbScan  . . . . . . . . . . . . . . . . . . . . . . .     III - 1
  39.                1.1. The Purpose of TbScan  . . . . . . . . . . . .     III - 1
  40.                1.2. How to use Tbscan  . . . . . . . . . . . . . .     III - 2
  41.                1.3. Command line options . . . . . . . . . . . . .     III - 9
  42.                1.4. The scanning process . . . . . . . . . . . . .    III - 14
  43.           2.  TbScanX  . . . . . . . . . . . . . . . . . . . . . .    III - 18
  44.                2.1. The Purpose of TbScanX . . . . . . . . . . . .    III - 18
  45.                2.2. How to use TbScanX . . . . . . . . . . . . . .    III - 18
  46.                2.3. Command line options . . . . . . . . . . . . .    III - 19
  47.                2.4. While scanning . . . . . . . . . . . . . . . .    III - 22
  48.           3.  TbCheck  . . . . . . . . . . . . . . . . . . . . . .    III - 23
  49.                3.1. The Purpose of TbCheck . . . . . . . . . . . .    III - 23
  50.                3.2. How to use TbCheck . . . . . . . . . . . . . .    III - 23
  51.                3.3. Command line options . . . . . . . . . . . . .    III - 24
  52.                3.4. While checking . . . . . . . . . . . . . . . .    III - 26
  53.                3.5. Testing TbCheck  . . . . . . . . . . . . . . .    III - 26
  54.           4. TbClean . . . . . . . . . . . . . . . . . . . . . . .    III - 27
  55.                4.1. The Purpose of TbClean . . . . . . . . . . . .    III - 27
  56.                4.2. How to use TbClean . . . . . . . . . . . . . .    III - 28
  57.                4.3. Command line options . . . . . . . . . . . . .    III - 30
  58.                4.4. The cleaning process . . . . . . . . . . . . .    III - 31
  59. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                  CONTENTS
  60.  
  61.  
  62.           5. Ongoing virus prevention: TbMon . . . . . . . . . . .    III - 35
  63.                5.1. TbMem  . . . . . . . . . . . . . . . . . . . .    III - 37
  64.                5.2. TbFile . . . . . . . . . . . . . . . . . . . .    III - 40
  65.                5.3. TbDisk . . . . . . . . . . . . . . . . . . . .    III - 42
  66.           6. TBAV Tools  . . . . . . . . . . . . . . . . . . . . .    III - 48
  67.                6.1. TbUtil . . . . . . . . . . . . . . . . . . . .    III - 48
  68.                6.2. StackMan . . . . . . . . . . . . . . . . . . .    III - 56
  69.  
  70.      SECTION IV. ADVANCED USER INFORMATION
  71.           1. Memory requirements . . . . . . . . . . . . . . . . . .    IV - 1
  72.           2. TbSetup . . . . . . . . . . . . . . . . . . . . . . . .    IV - 3
  73.                2.1. Anti-Vir.Dat design considerations . . . . . . .    IV - 3
  74.                2.2. Format of TbSetup.Dat  . . . . . . . . . . . . .    IV - 3
  75.                2.3. TBAV site installation . . . . . . . . . . . . .    IV - 5
  76.           3. TbScan  . . . . . . . . . . . . . . . . . . . . . . . .    IV - 7
  77.                3.1. Heuristic scanning . . . . . . . . . . . . . . .    IV - 7
  78.                3.2. Integrity checking . . . . . . . . . . . . . . .    IV - 8
  79.                3.3. Program validation . . . . . . . . . . . . . . .    IV - 9
  80.                3.4. The algorithms . . . . . . . . . . . . . . . . .    IV - 9
  81.                3.5. The TbScan.Lng file  . . . . . . . . . . . . .     IV - 10
  82.           4. TbClean . . . . . . . . . . . . . . . . . . . . . . .     IV - 12
  83.           5. TbGensig  . . . . . . . . . . . . . . . . . . . . . .     IV - 15
  84.                5.1 The Purpose of TbGenSig . . . . . . . . . . . .     IV - 15
  85.                5.2 Defining signatures . . . . . . . . . . . . . .     IV - 15
  86.                5.3 Keywords  . . . . . . . . . . . . . . . . . . .     IV - 18
  87.                5.4 Wildcards . . . . . . . . . . . . . . . . . . .     IV - 21
  88.  
  89.      APPENDIX A. TBAV messages
  90.  
  91.      APPENDIX B. TbScan - Heuristic flag descriptions
  92.  
  93.      APPENDIX C. Solving incompatibility problems
  94.  
  95.      Appendix D. Exit codes
  96.  
  97.      Appendix E. Virus naming
  98. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION 0
  99.  
  100.  
  101. SECTION 0. INTRODUCTION
  102.  
  103.  
  104. 1. How to use the manual
  105.  
  106.      Congratulations! By purchasing the ThunderBYTE Anti-Virus utilities you
  107.      have taken the basic step in building a massive anti-viral safety wall
  108.      around your precious computer system. Setting up the appropriate defen-
  109.      se, using the TBAV utilities, is a 'personal matter'. Therefore, we
  110.      highly recommend to read this manual thoroughly, so you are well aware
  111.      of all different kinds of security measures you may take. 
  112.  
  113.      This manual consists of four main sections. Section I instructs you how
  114.      to install the TBAV utilities on your hard disk(s), including some
  115.      useful hints on customized initialization. Section II gives an instruc-
  116.      tion on how to prevent viruses from infecting your computer system(s)
  117.      and directions on how to handle when you actually have been struck by a
  118.      computer virus.
  119.  
  120.      In section III, both purpose and functionality of all TBAV utilities are
  121.      described. For those who want to know more about the subject, some
  122.      'advanced user information' on the ThunderBYTE Anti-Virus utilities is
  123.      presented in section IV. 
  124.  
  125.      You may use the TBAV manual as a reference manual, via an extensive
  126.      index and appendices referring to the TBAV error messages. 
  127.  
  128. =>   Note that a complete reading of the manual is indispensible in order to
  129.      become familiar with the many facets of ThunderBYTE Anti-Virus, to know
  130.      what steps can - and must - be taken to ensure adequate protection and
  131.      to be fully prepared for a complete recovery, if and when disaster
  132.      strikes. 
  133.  
  134.  
  135. 2. Overview of the TBAV utilities
  136.  
  137.      What is ThunderBYTE Anti-Virus?
  138.  
  139.      ThunderBYTE Anti-Virus (TBAV) is a comprehensive toolkit designed to
  140.      protect against - and recover from - computer viruses. While TBAV
  141.      focuses heavily on numerous ways to prevent a virus infection, the
  142.      package would not be complete without various cleaner programs to purge
  143.      a system, in the unlikely event that a virus manages to slip through.
  144.      The package therefore consists of a number of programs each of which
  145.      help you to prevent viruses to do their destructive jobs. Here is a
  146.      quick overview. 
  147.  
  148.  
  149.      Collecting software information: TbSetup
  150.  
  151.      TbSetup is a program that collects information from all software found
  152.      on your system. The information will be put in files named Anti-Vir.Dat.
  153.  
  154.                                        0 - 1
  155. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION 0
  156.  
  157.  
  158.      The information maintained in these files can be used for integrity
  159.      checking, program validation, and to clean infected files.
  160.  
  161.  
  162.      Enable memory resident TBAV utilities: TbDriver
  163.  
  164.      TbDriver does not provide protection against viruses by itself, but must
  165.      be loaded in advance to enable the memory resident ThunderBYTE Anti-
  166.      Virus utilities, such as TbScanX, TbCheck, TbMem, TbFile and TbDisk to
  167.      do their job properly. 
  168.  
  169.  
  170.      Scanning for viruses: TbScan
  171.  
  172.      TbScan is both a very fast signature scanner and a so-called heuristic
  173.      scanner. Besides its blazing speed it has many configuration options. It
  174.      can detect mutants of viruses, it can bypass stealth type viruses, etc.
  175.      The signature file used by TbScan is a coded 'TbScan.Sig' file, which
  176.      can be updated by yourself in case of emergency.  TbScan is able to
  177.      disassemble files. This makes it possible to detect suspicious instruc-
  178.      tion sequences and to detect yet unknown viruses. This generic detecti-
  179.      on, named heuristic analysis, is a technique that makes it possible to
  180.      detect about 90% of all viruses by searching for suspicious instruction
  181.      se-quences rather than using any signature. For that purpose TbScan
  182.      contains a real disassembler and code analyzer.
  183.  
  184.      Another feature of TbScan is the integrity checking it performs when it
  185.      finds the Anti-Vir.Dat files generated by TbSetup. 'Integrity checking'
  186.      means that TbScan will check that every file being scanned matches the
  187.      information maintained in the Anti-Vir.Dat files. If a virus infects a
  188.      file, the maintained information will not match the now changed file
  189.      anymore, and TbScan will inform you about this. 
  190.  
  191.      TbScan performs an integrity check automatically, and it does not have
  192.      the false alarm rate other integrity checkers have. The goal is to
  193.      detect viruses and not to detect configuration changes!
  194.  
  195.  
  196.      Automatic scanning: TbScanX
  197.  
  198.      TbScanX is the memory resident version of TbScan. This signature scanner
  199.      remains resident in memory and automatically scans those files which are
  200.      being executed, copied, de-archived, downloaded, etc. TbScanX does not
  201.      require much memory. It can swap itself into expanded, XMS, or high
  202.      memory, using only 1Kb of conventional memory.
  203.  
  204.  
  205.      Check while loading: TbCheck
  206.  
  207.      TbCheck is a memory resident integrity checker. This program remains
  208.      resident in memory and checks automatically every file just before it is
  209.      being executed. TbCheck uses a fast integrity checking method, consuming
  210.  
  211.                                        0 - 2
  212. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION 0
  213.  
  214.  
  215.      only 400 bytes of memory. It can be configured to reject files with
  216.      incorrect checksums, and/or to reject files that do not have a corres-
  217.      ponding Anti-Vir.Dat record.
  218.  
  219.  
  220.      Restoring infected boot-sector, CMOS and partition tables: TbUtil
  221.  
  222.      Some viruses copy themselves into the hard disk's partition table, which
  223.      makes them far more difficult to remove than bootsector viruses. Perfor-
  224.      ming a low-level format is an effective, but rather drastic measure.
  225.      TbUtil offers a more convenient alternative by making a precautionary
  226.      back-up of uninfected partition tables and the boot sector. If an
  227.      infection occurs, the TbUtil back-up can be used as a verifying tool and
  228.      as a means to restore the original (uninfected) partition table and
  229.      bootsector without the need for a destructive disk format. The program
  230.      can also restore the CMOS configuration for you. If a back-up of your
  231.      partition table is not available, TbUtil will try to create a new
  232.      partition table anyway, again avoiding the need for a low-level format. 
  233.  
  234.      Another important feature of TbUtil is the option to replace the parti-
  235.      tion table code with new code offering greater resistance to viruses.
  236.      The TbUtil partition code is executed before the boot sector gains
  237.      control, enabling it to check this sector in a clean environment. The
  238.      TbUtil partition code performs a CRC calculation on the master boot
  239.      sector just before the boot sector code is activated and issues a
  240.      warning if the boot sector has been modified. The TbUtil partition code
  241.      also checks and reports changes in the RAM lay-out. These checks are
  242.      carried out whenever the computer is booted from the hard disk.
  243.  
  244.      It should be noted that boot sector verification is imperative before
  245.      allowing the boot sector code to execute. A virus could easily become
  246.      resident in memory during boot-up and hide its
  247.      presence. TbUtil offers total security at this stage by being active
  248.      before the boot sector is executed. Obviously, TbUtil is far more
  249.      convenient than the traditional strategy of booting from a clean DOS
  250.      diskette for an undisturbed inspection of the boot sector.
  251.  
  252.  
  253.      Reconstructing infected files: TbClean
  254.  
  255.      TbClean is a generic file cleaning utility. It uses the Anti-Vir.Dat
  256.      files generated by TbSetup to enhance file cleaning and/or to verify the
  257.      results. TbClean can however also work without these files. It disassem-
  258.      bles and emulates the infected file and uses this analysis to recon-
  259.      struct the original file.
  260.  
  261.  
  262.      Resident safeguard: TbMon
  263.  
  264.      TbMon is a set of memory resident anti-virus utilities, consisting of
  265.      TbMem, TbFile and TbDisk. Most other resident anti-virus products offer
  266.      you the choice to invoke them before the network is loaded and losing
  267.  
  268.                                        0 - 3
  269. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION 0
  270.  
  271.  
  272.      the protection after the logon procedure, or to load the anti-viral
  273.      software AFTER the logon to the network, resulting in a partially
  274.      unprotected system. The ThunderBYTE Anti-Virus utilities however recog-
  275.      nize the network software and take appropriate actions to ensure their
  276.      functionality.
  277.  
  278.  
  279.      Controlling memory: TbMem
  280.  
  281.      TbMem detects attempts from programs to remain resident in memory, and
  282.      makes sure that no program can remain resident in memory without permis-
  283.      sion. Since most viruses remain resident in memory, this is a powerful
  284.      weapon against all those viruses, known or unknown. Permission informa-
  285.      tion is maintained in the Anti-Vir.Dat files.
  286.  
  287.  
  288.      Preventing infection: TbFile
  289.  
  290.      TbFile detects attempts from programs to infect other programs. It also
  291.      guards read-only attributes, detects illegal time-stamps, etc. It will
  292.      make sure that no virus succeeds in infecting programs.
  293.  
  294.  
  295.      Protecting the disk: TbDisk
  296.  
  297.      TbDisk is a disk guard program which detects attempts from programs to
  298.      write directly to disk (without using DOS), attempts to format, etc.,
  299.      and makes sure that no malicious program will succeed in destroying your
  300.      data. This utility also traps tunneling and direct calls into the BIOS
  301.      code. Permission information about the rare programs that write directly
  302.      and/or format the disk is maintained in the Anti-Vir.Dat files.
  303.  
  304.  
  305.      Define your own signatures (in case of an emergency): TbGensig
  306.  
  307.      Since TBAV is distributed with an up-to-date, ready-to-use signature
  308.      file, you do not really need to maintain a signature file yourself. If,
  309.      however, you want to define your own virus signatures, you will need the
  310.      TbGensig utility. You can use either published signatures or define your
  311.      own ones if you are familiar with the structure of software.
  312.  
  313.  
  314.      Remove infected files: TbDel
  315.  
  316.      The DOS 'DEL' command does not actually erase a file. It simply changes
  317.      the first filename character in the directory listing and frees up the
  318.      space by changing the disk's internal location tables. TbDel is a small
  319.      program with just one but important purpose: it replaces every single
  320.      byte in a file with zero characters before deleting it. The entire
  321.      contents are therefore obliterated and totally unrecoverable.
  322.  
  323.  
  324.  
  325.                                        0 - 4
  326. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION 0
  327.  
  328.  
  329.      An effective stack manager: StackMan
  330.  
  331.      To avoid problems with memory resident software ('TSR' programs) DOS is
  332.      able to maintain a stack pool and to switch to a dedicated stack if a
  333.      hardware interrupt occurs. The "Stacks" statement in the Config.Sys can
  334.      be used to control this stack pool. The DOS stack switching however, has
  335.      some drawbacks. TBAV StackMan offers important additional functionality
  336.      above the DOS "Stacks" command.
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.                                        0 - 5
  383. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  384.  
  385.  
  386. SECTION I. INSTALLING TBAV
  387.  
  388.  
  389. 1. How to install TBAV 
  390.  
  391.  
  392.      System requirements
  393.  
  394.      The ThunderBYTE Anti-Virus utilities can be executed on any IBM or
  395.      compatible PC with at least 1 Mb disk space. The TBAV utilities need 256
  396.      Kb free internal memory and require DOS 3. However, DOS 5 or a later
  397.      version is recommended. The TBAV utilities are compatible with networks,
  398.      Windows, DR-DOS, etc. 
  399.  
  400.  
  401. 1.1 Initial installation
  402.  
  403.      You can install the TBAV utilities either by using the installation
  404.      procedure (which is explained below) or by a fully customized TBAV
  405.      installation (which is explained in sections  I - 3 and II).
  406.  
  407.      Insert the TBAV installation diskette in the diskette drive.
  408.  
  409.      Type:
  410.           A: or B:
  411.  
  412.      Type:
  413.           install C:\TBAV <Enter>
  414.  
  415.  
  416.           +---------------------------------------+
  417.           |    F1  First time installation        |
  418.           |    F2  Update installation            |
  419.           |    F3  About....                      |
  420.           |    F4  Exit....                       |
  421.           +---------------------------------------+
  422.  
  423.      Since this is the first time you install the TBAV package you choose the
  424.      first option by pressing <Enter> or <F1>.
  425.  
  426.  
  427.      ----- [ Please select Drive to install TBAV to: ]-----               You
  428.      need at least 1024 KB of available space to install TBAV !
  429.  
  430.                C:     3581952 
  431.                D:    21291008
  432.  
  433.  
  434.      Toggle to the disk on which the TBAV utilities must be installed. TBAV
  435.      Install displays the amount of free disk space of each available disk.
  436.  
  437.  
  438.  
  439.                                        I - 1
  440. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  441.  
  442.  
  443.      Next, TBAV Install will prompt you for the TBAV directory. The default
  444.      directory is \TBAV:
  445.  
  446.  
  447.      -----[ Please select Directory to install TBAV to: ]-----
  448.           [C:\TBAV                                      ] 
  449.  
  450.  
  451.      If the specified directory does not exist, the installation pro-gram
  452.      will create it. Subsequently, the TBAV files are copied onto your hard
  453.      disk.
  454.  
  455.      +-----------------------------------------------------------+
  456.      |    The documentation for TBAV is compressed into a file.  |
  457.      |    The documentation-file will now be self-extracted.     |
  458.      |    Press any key when ready....                           |
  459.      |                                                           |
  460.      |                                                           |
  461.      |         Inflating: c:/tbav/TBSCAN.DOC    -AV              |
  462.      |         Inflating: c:/tbav/TBSCANX.DOC   -AV              |
  463.      |         Inflating: c:/tbav/TBCLEAN.DOC   -AV              |
  464.      +-----------------------------------------------------------+
  465.  
  466.      The packed text files are copied onto your hard disk and inflated. After
  467.      copying all files, TbSetup is loaded, which will generate or update the
  468.      Anti-Vir.Dat file of the TBAV directory.
  469.  
  470.  
  471.      +-----------------------------------------------------------+
  472.      |    TbSetup will now generate or update the Anti-Vir.Dat   |
  473.      |         file of the directory C:\TBAV                     |
  474.      |              Press any key when ready...                  |
  475.      +-----------------------------------------------------------+
  476.  
  477.      The ThunderBYTE Anti-Virus utilities are copied to the destination
  478.      directory. The installation program helps you to setup the utilities in
  479.      their most standard and non-customized way. After reading the manual
  480.      thoroughly, you can configure the package to suit your own personal
  481.      needs.
  482.  
  483.      +-----------------------------------------------------------+
  484.      | This installation program helps you to setup the utilities|
  485.      |         in their most standard and non-customized way.    |
  486.      |              Do you want to continue ? (Y/N)              |
  487.      +-----------------------------------------------------------+
  488.  
  489.      If 'No', TBAV Install will not prompt you for placing the memory resi-
  490.      dent TBAV utilities in the autoexec.bat file, nor for creating the Anti-
  491.      Vir.Dat files. If yes, TBAV Install backs up your original Autoexec.Bat
  492.      file and appends a call to the tbstart.bat file. For easy access of the
  493.      TBAV utilities it is recomended to put them into your PATH environment
  494.      variable. Your Autoexec.Bat file now looks like this:
  495.  
  496.                                        I - 2
  497. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  498.  
  499.  
  500.           @ECHO OFF
  501.           PATH C:\TBAV
  502.  
  503.           call C:\TBAV\tbstart.bat
  504.  
  505.      Subsequently, TbSetup will process the indicated drive to generate the
  506.      Anti-Vir.Dat files. You may need to repeat this process for other
  507.      drives. Consult the relevant section for more information!
  508.  
  509.  
  510.      The TBAV package contains some utilities that can be instal-
  511.      led in the memory of your PC. For each of these utilities you can
  512.      indicate whether the installation program must add them to the
  513.      Tbstart.bat file:
  514.  
  515.           TBSCANX is a memory resident virus scanner.
  516.                Do you want to install it ? (Y/N)
  517.  
  518.           TBCHECK is a memory resident integrity checker.
  519.                Do you want to install it ? (Y/N)
  520.  
  521.           TBMEM is a resident memory guard.
  522.                Do you want to install it ? (Y/N
  523.  
  524.           TBFILE is a resident file guard.
  525.                Do you want to install it ? (Y/N)
  526.  
  527.  
  528.      If you answer the subsequent question with Yes, TBAV will scan your
  529.      system for viruses automatically once every day:
  530.  
  531.           Do you want the system to be scanned automatically
  532.                for viruses every day ? (Y/N)
  533.  
  534.  
  535.      The installation program will write the indicated configuration values
  536.      in the 'tbstart.bat' file, which is located in the Thunder-BYTE directo-
  537.      ry you specified before, eg.:
  538.  
  539.           C:\TBAV\tbdriver
  540.           C:\TBAV\tbscanx
  541.           C:\TBAV\tbcheck
  542.           C:\TBAV\tbmem
  543.           C:\TBAV\tbfile
  544.           C:\TBAV\tbscan once C:\
  545.  
  546.      Finally, you can force the TBAV utilities to scan your disk right away.
  547.  
  548.      It is very likely that some of the TBAV utilities are going to display
  549.      messages when you reboot and continue using the computer as you normally
  550.      would. Some programs perform operations that are monitored by the TBAV
  551.      utilities, so TBAV must first 'learn' which programs need proper permis-
  552.  
  553.                                        I - 3
  554. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  555.  
  556.  
  557.      sion. Execute some of the programs you use regularly and at each rele-
  558.      vant query respond with 'Y' to authorize or 'N' to deny permission. TBAV
  559.      will remember the settings and not bother you again. Reboot the computer
  560.      at the end of this test run. 
  561.  
  562.      The TBAV utilities are now ready to monitor the system and
  563.      will issue a warning if something suspicious - or worse - is
  564.      about to happen. They will also warn you if any new file
  565.      contains a possible virus - well before it can do any harm.
  566.  
  567.  
  568. 1.2 Windows
  569.  
  570.      When used under Windows, the utilities remain active in every DOS box,
  571.      without interfering with the operation of adjacent windows. All TBAV
  572.      utilities may be loaded in a graphics DOS box inside Windows, providing
  573.      trouble-free support using a no-nonsense interface.
  574.  
  575.      There are a number of good reasons for this TBAV package design strate-
  576.      gy, at the risk of alienating Windows fans expecting ornate GUI applica-
  577.      tions. A Windows based scanner may look prettier, but offers no added
  578.      functionality. On the contrary, a graphics interface requires more
  579.      system resources, inflates program size, performs more sluggishly and
  580.      puts a penalty on overall reliability. 
  581.  
  582.      Also, consider what happens if one of the Windows executables becomes
  583.      infected. From that point onwards Windows may very well refuse to work
  584.      altogether and simply hang the computer. Your Windows based scanner will
  585.      not do you much good at this point - just when you need it most, you
  586.      can't start it up in order to find out what went wrong. 
  587.  
  588.      And what about another dilemma. In order to be able to cope with stealth
  589.      viruses you must power down and reboot from a clean DOS diskette prior
  590.      to scanning or checking - but have you ever tried to boot Windows 3.1
  591.      from a diskette? 
  592.  
  593.  
  594.      TBAV menu and command syntax
  595.  
  596.      You can activate most of the TBAV utilities from within the TBAV menu,
  597.      by loading:
  598.  
  599.           cd\tbav
  600.           tbav
  601.  
  602.      In order to execute the utilities automatically, all TBAV drivers and
  603.      utilities may be executed from the DOS prompt. In a systemized setup,
  604.      however, the drivers should be installed and activated in your Con-
  605.      fig.Sys, with a device= or install= directive, or in the TbStart.Bat
  606.      file as a TSR. Similarly, most utilities can be started automatically -
  607.      in the case of TbScan restricted to once a day - in the TbStart.Bat
  608.  
  609.  
  610.                                        I - 4
  611. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  612.  
  613.  
  614.      file. The two exceptions are TbClean and TbDel, which should be executed
  615.      only from the DOS prompt and (TbClean) from within the TBAV menu.
  616.  
  617.      All commands for ThunderBYTE Anti-Virus can be used with command line
  618.      switches or options to control special features. The options may either
  619.      be written out in full, or abbreviated to their one- or two-letter
  620.      mnemonic to shorten the command line. Throughout this manual the exam-
  621.      ples are given with options in verbose, unabbreviated form for clarity.
  622.      Options must be separated by spaces. They do not need a preceding switch
  623.      character, but you may use the customary slash or hyphen switch charac-
  624.      ters if you wish.
  625.  
  626.      The standard command line syntax for all ThunderBYTE Anti-Virus commands
  627.      is:
  628.  
  629.           command [<path>] [<filename>] [<option>] ... [<suboption>] ...
  630.  
  631.      You may review the correct syntax for any command, including a complete
  632.      option list, with the command followed by the word 'help' or a question
  633.      mark, as in:
  634.  
  635.           tbcheck ?
  636.  
  637.      The same on-line help is provided whenever the command is issued with an
  638.      invalid option.
  639.  
  640.      The examples, presented in this manual assume that all utilities were
  641.      installed in the default \TBAV directory.
  642.  
  643.  
  644.      Create a recovery diskette!
  645.  
  646.      It is highly recommended to make a recovery diskette. The example setups
  647.      assume you have created such a recovery diskette (see the instructions
  648.      in section II). 
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.                                        I - 5
  668. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  669.  
  670.  
  671. 2. Configuration
  672.  
  673.      The choices you made when installing the TBAV utilities may need some
  674.      tuning, for instance by appending options to the loading command. This
  675.      tuning can be done by editing the TBSTART.BAT file, which automatically
  676.      loads the memory resident utilities. 
  677.  
  678. =>   If suitable, you may write the relevant commands in the Config.Sys file
  679.      instead. Do not forget to specify the .EXE extension in the Config.Sys
  680.      file!
  681.  
  682.      Below, some basic hints are presented, to customize the initial settings
  683.      to suit your own needs. After initializing and rebooting your system for
  684.      the first time afterwards, TBAV will need your response in the initial
  685.      'learning' stage.
  686.  
  687.  
  688.      TBAV menu configuration
  689.  
  690.      The TBAV menu allows some configuration, as well.
  691.  
  692.      +----Main menu-----+
  693.      |  Confi+----------TBAV configuration----------+
  694.      |  TbSet|v Use colors                          |
  695.      |  TbSca|  Save configuration to TBAV.INI      |
  696.      |  TbUti|  File view utility                   |
  697.      |  TbCLe|v Wait after program execution        |
  698.      |  TBAV |  Display cmd line before executing   |
  699.      |  Docum|v Edit command line before executing  |
  700.      |  Quit +--------------------------------------+
  701.      |  eXit (no save)  |
  702.      +------------------+
  703.  
  704.      You can activate the configuration options by toggling to the relevant
  705.      choice and pressing <Enter>.
  706.  
  707.  
  708.      Use colors
  709.  
  710.      If disabled, TBAV will be displayed in monochrome mode, which is conve-
  711.      nient for use on laptop computers.
  712.  
  713.  
  714.      Save configuration to TBAV.INI
  715.  
  716.      All configuration values, set within the TBAV menu, are saved in the
  717.      'TBAV.INI' file, once you have selected this option. The next time you
  718.      load the TBAV utilities the configuration values in the current TBAV.INI
  719.      file will be valid. These values apply to the TBAV menu itself and the
  720.      utilities TbSetup, TbScan and TbClean. Although you may edit the TBAV.I-
  721.      NI file manually, it is recommended to let the TBAV menu shell generate
  722.      it. By default, the contents of the TBAV.INI file is only valid while
  723.  
  724.                                        I - 6
  725. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  726.  
  727.  
  728.      using the TBAV menu shell. You may, however, enable the "Use TBAV.INI
  729.      file" options (or specify the 'UseIni' switches in the TBAV.INI file
  730.      itself) for each of the utilities mentioned above. Doing so, the confi-
  731.      guration, saved in the TBAV.INI file will also be valid when TbSetup,
  732.      TbScan or TbClean are loaded from the command line. Be careful, since
  733.      options specified in the TBAV.INI file can not be undone on the command
  734.      line. TBAV will create a TBAV.INI file when enabling this option for the
  735.      first time. In this file all valid configuration switches are listed.
  736.      The disabled switches are preceded by a semicolon.
  737.  
  738.  
  739.      File view utility
  740.  
  741.      TbSetup and TbScan generate a datafile and a logfile respectively. By
  742.      default, you can view these files from the TBAV menu using an internal
  743.      file view utility. By using this option you are able to attach your
  744.      favorite external file view utility. Enter the complete path and the
  745.      file name, including the extension.
  746.  
  747.  
  748.      Wait after program execution
  749.  
  750.      By enabling this option, TBAV will display the message:
  751.      "Press any key to return to the TBAV utilities" after executing an
  752.      external utility.
  753.  
  754.  
  755.      Display command line before executing
  756.  
  757.      Enabling this option will force TBAV to display the DOS command, which
  758.      will load the external utility. This option comes in handy in order to
  759.      see the command(s) you specified before. After pressing <Enter> TBAV
  760.      will execute the DOS 
  761.      commands.
  762.  
  763.  
  764.      Edit command line before executing
  765.  
  766.      If enabled, you may change the DOS command, which will load the external
  767.      utility.
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.                                        I - 7
  782. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  783.  
  784.  
  785. 3. TbSetup
  786.  
  787.  
  788. 3.1. The Purpose of TbSetup
  789.  
  790.      TbSetup is an indispensible tool, adding support to the rest of the
  791.      ThunderBYTE Anti-Virus utilities, even though it does not take an active
  792.      part in actual virus detection or cleaning itself. TbSetup organizes
  793.      control and recovery information giving extra power to the other utili-
  794.      ties. The information is gathered, mainly from program files, into a
  795.      single reference file called Anti-Vir.Dat, one each per directory. The
  796.      nature of Anti-Vir.Dat files will be explained more fully at the end of
  797.      this chapter.
  798.  
  799.      Although the ThunderBYTE utilities can work perfectly well without the
  800.      Anti-Vir.Dat files it is highly recommended to have TbSetup generate
  801.      these files. The Anti-Vir.Dat files can be used for several purposes:
  802.  
  803.      Integrity checking. TbScan and the memory resident TbCheck program will
  804.      perform an integrity check while scanning if it can detect the Anti-
  805.      Vir.Dat file. If a file gets infected by a virus, the information in the 
  806.      Anti-Vir.Dat file will not match the actual file contents, and TbScan
  807.      and TbCheck will inform you that the file has been changed. 
  808.  
  809.      The TbSetup program recognizes some files that need special treatment.
  810.      An example of such a file is a disk image file of a network remote boot
  811.      disk. - Such a file that actually represents a complete disk - should be
  812.      scanned completely, and for all viruses. TbSetup will put a mark in the
  813.      Anti-Vir.Dat file to make sure that TbScan scans the complete file for
  814.      all viruses.
  815.  
  816.      Once a file is infected, TbClean will reconstruct the original file. The
  817.      information in the Anti-Vir.Dat file will be of great help to TbClean.
  818.      Some infected programs can only be cured if there is information about
  819.      the program in the Anti-Vir.Dat file.
  820.  
  821.      TbCheck (a tiny resident integrity checker) has no purpose if there are
  822.      no Anti-Vir.Dat files on your system.
  823.  
  824.      The resident TBAV utilities need the Anti-Vir.Dat files to maintain
  825.      permission information. Without Anti-Vir.Dat files you can not get rid
  826.      of false alarms other than by disabling a complete feature.
  827.  
  828.  
  829. 3.2. How to use TbSetup
  830.  
  831.      This is the one program where the rule applies: The less you use the
  832.      program, the better your protection against viruses! Why? Keep in mind
  833.      that an Anti-Vir.Dat file stores vital information needed to detect a
  834.      virus, as well as data for subsequent recovery and for cleaning. But
  835.      consider what would happen if you were to execute TbSetup after a virus
  836.      entered the system: the information in the Anti-Vir.Dat file would be
  837.  
  838.                                        I - 8
  839. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  840.  
  841.  
  842.      'updated' to the state of the infected file, wiping out all traces of
  843.      data needed to reconstruct the file of the original, uninfected state.
  844.      Never use TbSetup when there is the slightest evidence of a virus in
  845.      your system. Once the Anti-Vir.Dat files have been generated as part of
  846.      the initial setup, any subsequent usage of TbSetup should be confined to
  847.      directories with new or changed program files.
  848.  
  849.      Please note that the Anti-Vir.Dat directory entries will have the
  850.      attribute 'hidden' and therefore do not show up when you use standard
  851.      directory commands. You can see the filenames only with the help of
  852.      special utilities.
  853.  
  854.      You may load TbSetup either from the DOS command line or from the TBAV
  855.      menu. Drive and path tell TbSetup where it should perform its setup
  856.      operation. To setup disks C: and D: you should enter:
  857.  
  858.           TbSetup C:\ D:\
  859.  
  860.      When no filename has been specified but a drive and/or path instead, the
  861.      specified path will be used as top-level path. All its sub-directories
  862.      will be processed too. When a filename has been specified only the
  863.      specified path will be processed. Sub-directories will not be processed.
  864.  
  865.  
  866.      Wildcards in the filename are allowed.
  867.  
  868.      When executed from the DOS command line, the 'newonly' option can be
  869.      used to prevent existing information from being overwritten. 
  870.      To help you remember that TbSetup needs to be executed again, the next
  871.      time you execute TbScan it will display either a small 'c' after the
  872.      file to indicate a new file or a capital 'C' if a file has simply been
  873.      changed.
  874.  
  875.      Example:
  876.      You add a new file TEST.EXE to your directory C:\FOO.
  877.  
  878.           TbSetup C:\FOO\TEST.EXE
  879.  
  880.  
  881.      Example:
  882.      You install a new product in a new directory C:\NEW.
  883.  
  884.           TbSetup C:\NEW
  885.  
  886.  
  887.      When using the DOS command you may append a number of loading options.
  888.      These options are presented in section 3.3. of this chapter.
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.                                        I - 9
  896. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  897.  
  898.  
  899.      The 'TbSetup' menu
  900.  
  901.  
  902.      +----Main menu-----+
  903.      |  Confi+------TbSetup menu------+
  904.      |  TbSet|  Start TbSetup         |
  905.      |  TbSca|  Files/Paths to setup  |
  906.      |  TbUti|  Options menu         >|
  907.      |  TbCLe|  Flags menu           >|
  908.      |  TBAV |  Data file path/name   |
  909.      |  Docum|  View data file        |
  910.      |  Quit +------------------------+
  911.      |  eXit (no save)  |
  912.      +------------------+
  913.  
  914.  
  915.      Data file path/name 
  916.  
  917.      TbSetup will search for 'special' files in a file named TbSetup.Dat.
  918.      After selecting this option 'datfile' you can specify another path or
  919.      filename that contains a list of 'special' files. Option format: Datfile
  920.      [=<filename>]
  921.  
  922.      Example:            
  923.           TbSetup Datfile = c:\tbav\tbsetup.dat
  924.  
  925.  
  926.      +----Main menu-----+
  927.      |  Confi+------TbSetup menu------+
  928.      |  TbSet|  Start+-------TbSetup options-------+
  929.      |  TbSca|  Files|  Use TBAV.INI file          |
  930.      |  TbUti|  Optio|  Prompt for pause           |
  931.      |  TbCLe|  Flags|  Only new files             |
  932.      |  TBAV |  Data |  Remove Anti-Vir.Dat files  |
  933.      |  Docum|  View |  Do not change anything     |
  934.      |  Quit +-------|v Hide Anti-Vir.Dat files    |
  935.      |  eXit (no save|  Make executables readonly  |
  936.      +---------------|  Clear readonly attributes  |
  937.                      |v Sub-Directory scan         |
  938.                      +-----------------------------+
  939.  
  940.  
  941.      Use TBAV.INI file
  942.  
  943.      By enabling this option, the TbSetup configuration values, saved in the
  944.      TBAV.INI file, will also be valid when loading TbSetup from the command
  945.      line. Be careful, since options specified in the TBAV.INI file can not
  946.      be undone on the command line. See chapter I-2 ('Configuration').
  947.  
  948.  
  949.  
  950.  
  951.  
  952.                                       I - 10
  953. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  954.  
  955.  
  956.      Prompt for pause
  957.  
  958.      When you enter option 'pause' TbSetup will stop after it has processed
  959.      the contents of one window. This gives you the possibility to examine
  960.      the results.
  961.  
  962.  
  963.      Only new files 
  964.  
  965.      If you want to add new files to the Anti-Vir.Dat database, but prevent
  966.      the information of changed files from being updated 
  967.      use option 'newonly'. Updating the information of changed files is
  968.      dangerous because if the files are infected, the information to detect
  969.      and cure the virus will be overwritten. Option 'newonly' prevents the
  970.      information from being overwritten but it still allows information of
  971.      new files to be added to the database.
  972.  
  973.  
  974.      Remove Anti-Vir.Dat files 
  975.  
  976.      If you want to stop using the ThunderBYTE utilities you do not have to
  977.      remove all the Anti-Vir.Dat files yourself. By using this option TbSetup
  978.      will neatly remove all Anti-Vir.Dat files from your system.
  979.  
  980.  
  981.      Do not change anything 
  982.  
  983.      If you want to see the effect of an option without the risk that somet-
  984.      hing is activated you do not want, use option 'test'. If that option is
  985.      specified the program will behave as it would normally, but it will not
  986.      change or update anything on your
  987.      hard disk.
  988.  
  989.  
  990.      Hide Anti-Vir.Dat files 
  991.  
  992.      The Anti-Vir.Dat files are normally not visual in a directory listing.
  993.      If you prefer to have normal - i.e. visible - files disable this option. 
  994. =>   Note that this option only applies for new Anti-Vir.Dat files.
  995.  
  996.  
  997.      Make executables read-only 
  998.  
  999.      As TbFile guards the read-only attribute permanently it is highly
  1000.      recommended to make all executable files read-only to prevent any
  1001.      modifications on these files. TbSetup will do the job if you enable
  1002.      option 'read-only'. Files that should not be made read-only are recogni-
  1003.      zed by TbSetup.
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.                                       I - 11
  1010. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1011.  
  1012.  
  1013.      Clear read-only attributes 
  1014.  
  1015.      This option can be used to reverse the operation of option 'read-only'.
  1016.      If you enable this option all read-only attributes of all executable
  1017.      files will be cleared.
  1018.  
  1019.  
  1020.      Sub-Directory scan 
  1021.  
  1022.      By default TbSetup will search sub-directories for executable files,
  1023.      unless a filename (wildcards allowed!) has been specified. If you
  1024.      disable this option, TbSetup will not process sub-directories.
  1025.  
  1026.  
  1027.      +----Main menu-----+
  1028.      |  Confi+------TbSetup menu------+
  1029.      |  TbSet|  Start+-----TbSetup flags------+
  1030.      |  TbSca|  Files|v Use normal flags      |
  1031.      |  TbUti|  Optio|  Set flags manually    |
  1032.      |  TbCLe|  Flags|  Reset flags manually  |
  1033.      |  TBAV |  Data |  Define flags         >|
  1034.      |  Docum|  View +------------------------+
  1035.      |  Quit +------------------------+
  1036.      |  eXit (no save)  |
  1037.      +------------------+
  1038.  
  1039.  
  1040.      Set flags manually 
  1041.  
  1042.      This option is for advanced users only. With this option you can manual-
  1043.      ly set permission flags in the Anti-Vir.Dat record. This option requires
  1044.      a hexadecimal bitmask for the flags to set. For information about the
  1045.      bitmask consult the TbSetup.Dat file. 
  1046.  
  1047.      Option format: Set =<flags>
  1048.  
  1049.      Example: 
  1050.           Set = 0001
  1051.  
  1052.  
  1053.      Reset flags manually 
  1054.  
  1055.      This option is for advanced users only. With this option you can manual-
  1056.      ly reset permission flags or prevent flags to be set in the Anti-Vir.Dat
  1057.      record. This option requires a hexadecimal bitmask for the flags to
  1058.      reset.  For information about the bit mask consult the TbSetup.Dat file.
  1059.      Option format: Reset =<flags>
  1060.  
  1061.      Example:
  1062.           Reset = 0001
  1063.  
  1064.  
  1065.  
  1066.                                       I - 12
  1067. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1068.  
  1069.  
  1070.      +----Main menu-----+
  1071.      |  Confi+------TbSetup menu------+
  1072.      |  TbSet|  Start+-----TbSetup flags------+
  1073.      |  TbSca|  Files|v Use n+--Define flags to be changed--+
  1074.      |  TbUti|  Optio|  Set f|  0001: Heuristic analysis    |
  1075.      |  TbCLe|  Flags|  Reset|  0002: Checksum changes      |
  1076.      |  TBAV |  Data |  Defin|  0004: Disk image File       |
  1077.      |  Docum|  View +-------|  0008: Readonly sensitive    |
  1078.      |  Quit +---------------|  0010: TSR program           |
  1079.      |  eXit (no save)  |    |  0020: Direct disk access    |
  1080.      +------------------+    |  0040: Attribute modifier    |
  1081.                              |  8000: Interrupt rehook      |
  1082.                              +------------------------------+
  1083.  
  1084. 3.3. Command line options
  1085.  
  1086.      TbSetup allows options to be specified on the command line.  TbSetup
  1087.      recognizes option short-keys and option words. The words are easier to
  1088.      memorize, and they will be used in this manual for convenience. The
  1089.      syntax is as follows:
  1090.  
  1091.           TbSetup [<path>][<filename>]... [<options>]...
  1092.  
  1093.  
  1094.      option parameter      short  explanation
  1095.      ----------------------------------------------------------------
  1096.      help                  he   help (-? = short help)
  1097.      pause                 pa   enable 'Pause' prompt
  1098.      mono                  mo   force monochrome
  1099.      nosub                 ns   skip sub-directories
  1100.      newonly               no   do not update changed records
  1101.      remove                rm   remove Anti-Vir.Dat files
  1102.      test                  te   do not create / change anything
  1103.      nohidden              nh   do not make Anti-Vir.Dat files hidden 
  1104.      readonly              ro   set read-only attribute on executables
  1105.      nordonly              nr   remove / do not set read-only attribute
  1106.      set     =<flags>      se   set flags
  1107.      reset   =<flags>      re   reset flags / do not set flags
  1108.      datfile [=<filename>] df   data file to be used
  1109.  
  1110.  
  1111.      help (he)
  1112.      If you specify this option, TbSetup displays the contents of the TBSE-
  1113.      TUP.HLP file (if available) in the home directory of TbSetup.  If you
  1114.      specify the '?' option you will get the summarized help info as listed
  1115.      above.
  1116.  
  1117.      pause (pa)
  1118.      When you specify 'pause' TbSetup will stop after it has processed the
  1119.      contents of one window. This gives you the possibility to examine the
  1120.      results.
  1121.  
  1122.  
  1123.                                       I - 13
  1124. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1125.  
  1126.  
  1127.      mono (mo)
  1128.      This option forces TbSetup to refrain from using colors in the screen
  1129.      output. This might enhance the screen output on some LCD screens or
  1130.      color-emulating monochrome systems.
  1131.  
  1132.      nosub (ns)
  1133.      By default TbSetup will search sub-directories for executable files,
  1134.      unless a filename (wildcards allowed!) has been specified. If you
  1135.      specify this option, TbSetup will not process sub-directories.
  1136.  
  1137.      newonly (no)
  1138.      If you want to add new files to the Anti-Vir.Dat database, but prevent
  1139.      the information of changed files from being updated, use option 'newon-
  1140.      ly'. Updating the information of changed files is dangerous because if
  1141.      the files are infected, the information to detect and cure the virus
  1142.      will be overwritten. Option 'newonly' prevents the information from
  1143.      being overwritten but it still allows information of new files to be
  1144.      added to the database.
  1145.  
  1146.      remove (rm)
  1147.      If you want to stop using the ThunderBYTE utilities you do not have to
  1148.      remove all the Anti-Vir.Dat files yourself. By using this option TbSetup
  1149.      will neatly remove all Anti-Vir.Dat files from your system.
  1150.  
  1151.      test (te)
  1152.      If you want to see the effect of an option without the risk that somet-
  1153.      hing is activated you do not want, use option 'test'. If that option is
  1154.      specified the program will behave as it would normally, but it will not
  1155.      change or update anything on your
  1156.      hard disk.
  1157.  
  1158.      nohidden (nh)
  1159.      The Anti-Vir.Dat files are normally not visual in a directory listing.
  1160.      If you prefer to have normal - i.e. visible - files specify this option.
  1161. =>   Note that this option only applies for new Anti-Vir.Dat files.
  1162.  
  1163.      readonly (ro)
  1164.      As TbFile guards the read-only attribute permanently it is highly
  1165.      recommended to make all executable files read-only to prevent any
  1166.      modifications on these files. TbSetup will do the job if you enable
  1167.      option 'read-only'. Files that should not be made read-only are recogni-
  1168.      zed by TbSetup.
  1169.  
  1170.      nordonly (nr)
  1171.      This option can be used to reverse the operation of option 'read-only'.
  1172.      If you enable this option all read-only attributes of all executable
  1173.      files will be cleared.
  1174.  
  1175.      set (se)
  1176.      This option is for advanced users only. With this option you can manual-
  1177.      ly set permission flags in the Anti-Vir.Dat record. This option requires
  1178.  
  1179.  
  1180.                                       I - 14
  1181. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1182.  
  1183.  
  1184.      a hexadecimal bitmask for the flags to set. For information about the
  1185.      bitmask consult the TbSetup.Dat file. 
  1186.      Option format: Set =<flags>
  1187.  
  1188.      Example:
  1189.           Set = 0001
  1190.  
  1191.      reset (re)
  1192.      This option is for advanced users only. With this option you can manual-
  1193.      ly reset permission flags or prevent flags to be set in the Anti-Vir.Dat
  1194.      record. This option requires a hexadecimal bitmask for the flags to
  1195.      reset.  For information about the bit mask consult the TbSetup.Dat file.
  1196.      Option format: Reset =<flags>
  1197.  
  1198.      Example:
  1199.           Reset = 0001
  1200.  
  1201.      datfile (df)
  1202.      After the datfile option you can specify the name of the data file to be
  1203.      used.
  1204.  
  1205.  
  1206. 3.4. While executing
  1207.  
  1208.      TbSetup divides the screen into three windows: an information window
  1209.      displaying data file comments across the top of the screen, a scanning
  1210.      window on the left and a status window on the right.
  1211.  
  1212.      The lower left window lists the names of the files being processed,
  1213.      along with file specific information:
  1214.  
  1215.  
  1216.      TEST.EXE 01234  12AB23CD   Added    * 0001
  1217.      |        |      |          |        | |
  1218.      |        |      |          |        | |
  1219.      |        |      |          |        | 'flags' set for this file
  1220.      |        |      |          |        indicates 'special' file
  1221.      |        |      |          action performed
  1222.      |        |      32-bit CRC (checksum)
  1223.      |        file size in hexadecimal number
  1224.      name of file in process
  1225.  
  1226.  
  1227.      Do not be concerned if the information flies too fast for you to read,
  1228.      or if it puzzles you. You will probably never need these details anyway.
  1229.  
  1230.      The scanning window has an 'action performed' field indicating whether
  1231.      an entry in the Anti-Vir.Dat was added, changed or updated:
  1232.  
  1233.      Added
  1234.      There was no previous entry for this file in the Anti-Vir.Dat record. A
  1235.      new entry has been added.
  1236.  
  1237.                                       I - 15
  1238. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1239.  
  1240.  
  1241.      Changed
  1242.      There was an existing entry, but the file has been changed. The Anti-
  1243.      Vir.Dat information has been updated.
  1244.  
  1245.      Updated
  1246.      There was an Anti-Vir.Dat record and the file was found to be unchanged.
  1247.      TbSetup did, however, change some of the program's permission flags, on
  1248.      account of an entry in the TbSetup.Dat file, or in compliance with a
  1249.      'Set' or 'Reset' option. 
  1250.  
  1251.      The process may be aborted by pressing Ctrl-Break.
  1252.  
  1253.  
  1254.      Purpose of the TbSetup.Dat file
  1255.  
  1256.      Although the ThunderBYTE utilities perform well on almost every file
  1257.      without extra help, there are some files that need particular attention.
  1258.      TbSetup uses information collected in a special data file, TbSetup.Dat,
  1259.      to flag such files in the Anti-Vir.Dat file. The other ThunderBYTE
  1260.      utilities then use that information to determine how such a 'special'
  1261.      file should be treated:
  1262.  
  1263.  
  1264.      Examples of such files:
  1265.  
  1266.      Some programs maintain configuration information inside the executable
  1267.      file (EXE, COM) itself. Whenever you change the configuration of these
  1268.      programs, the executable file will change as well, along with its
  1269.      checksum. The new checksum will not match the one stored in the TbSe-
  1270.      tup.Dat file anymore. Since some ThunderBYTE utilities use this checksum
  1271.      information to verify integrity or cleanup results, they need to 'know'
  1272.      when a file's checksum is not a fixed item and should be allowed to
  1273.      change.
  1274.  
  1275.      TbScan can use generic detection methods such as 'heuristic' analysis to
  1276.      detect unknown viruses. Since heuristic analysis implies inevitable
  1277.      false alarms when a file looks like a virus, TbScan may have to decide
  1278.      not to do a heuristic analysis on such a program.
  1279.  
  1280.      Some of the ThunderBYTE utilities guard the read-only attribute and make
  1281.      sure that it can be removed only with the user's explicitpermission. A
  1282.      few programs, however, refuse to run properly with the read-only attri-
  1283.      bute set.
  1284.  
  1285.      TbScan's default scanning method performs perfectly well with just about
  1286.      any file, but there are some that need special analysis. Such a file is
  1287.      the Novell NET$DOS.SYS file, not a device driver - as the filename
  1288.      extension suggests - but a disk image of the bootable disk. It should be
  1289.      scanned completely and for all signatures, including COM and BOOT.
  1290.  
  1291.      The resident monitoring utilities of the TBAV package detect all sorts
  1292.      of virus-specific behaviour. Some programs, even though they may act
  1293.  
  1294.                                       I - 16
  1295. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1296.  
  1297.  
  1298.      like a virus, are still perfectly normal and should be permitted to be
  1299.      executed without TBAV interference.
  1300.  
  1301.      You need not be concerned to find that a few files will be excluded from
  1302.      heuristic analysis. Those files will still be scanned the conventional
  1303.      way for signatures and all the rest. Furthermore, no heuristic exclusion
  1304.      will be granted unless a file matches exactly with the entry in the
  1305.      TbSetup.Dat file - including its name, size and the 32-bit CRC checksum.
  1306.      This eliminates security holes effectively: if a listed file is already
  1307.      infected, its checksum won't match the 32-bit CRC in the TbSetup.Dat
  1308.      file and the exclusion will not apply. By the same token, if a program
  1309.      is infected at a later date, the result would be a change in at least
  1310.      one of its characteristics; the record in the Anti-Vir.Dat file will not
  1311.      match any longer and the file will be subject to full heuristic analysis
  1312.      like any other.
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.                                       I - 17
  1352. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1353.  
  1354.  
  1355. 4. TbDriver
  1356.  
  1357. 4.1. Purpose of TbDriver
  1358.  
  1359.      TbDriver does not provide protection against viruses by itself, but must
  1360.      be loaded in advance to enable the memory resident ThunderBYTE Anti-
  1361.      Virus utilities, such as TbScanX, TbCheck, TbMem, TbFile and TbDisk, to
  1362.      do their job properly. It is the source for some of the routines these
  1363.      utilities have in common, including support to generate the pop-up
  1364.      window routines, driving the translation unit which enables the possibi-
  1365.      lity of displaying messages in your native language, and support for
  1366.      networks.
  1367.  
  1368.  
  1369.      How to use TbDriver
  1370.  
  1371.      Loading TbDriver must be loaded before (one of) the other memory TbDri-
  1372.      ver resident TBAV utilities. For loading instructions, please  consult
  1373.      the following pages.
  1374.  
  1375.      In normal situations it is not necessary to use the 'net' option of
  1376.      TbDriver.
  1377.  
  1378.      If you install TbDriver on a machine that is booted from a boot ROM,
  1379.      specify the message file with the drive and path where it can be found
  1380.      AFTER the machine has booted. The default message file will not be
  1381.      accessible anymore after the machine has booted.
  1382.  
  1383.  
  1384. 4.2. Command line options
  1385.  
  1386.      Tbdriver allows loading options to be specified on the command line. A
  1387.      filename specification will be treated as a language file specification.
  1388.      The upper three options are always available, the other options are only
  1389.      available if TbDriver is not already memory resident.
  1390.  
  1391.  
  1392.      option  parameter      short explanation
  1393.      -------------------- --------------------------------
  1394.  
  1395.      help                 ?     display this helpscreen
  1396.      net                  n     force LAN support
  1397.      remove               r     remove TbDisk from memory
  1398.  
  1399.      mode    =<m|c>       m     override video mode
  1400.      noavok  =<drives>    o     assume permission when AV record is missing
  1401.      quiet                q     do not display activity
  1402.      secure               s     do not allow permission updates
  1403.      notunnel             t     do not detect tunneling
  1404.  
  1405.  
  1406.  
  1407.  
  1408.                                       I - 18
  1409. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1410.  
  1411.  
  1412.      help (?)
  1413.      If you specify this option TbDriver will show you the valid command line
  1414.      options as listed above.
  1415.  
  1416.      net (n)
  1417.      TbDriver cooperates well with most networks; in normal situations option
  1418.      'net' will not be needed at all. It should be used only if all of the
  1419.      following conditions are true: A connection to a Novell network is made,
  1420.      and TbDriver.Exe is started before the logon command was used, and there
  1421.      is no valid Anti-Vir.Dat record in the directory where the NET?.COM
  1422.      program resides, or after the NET?.COM file has been renamed.
  1423.  
  1424.      remove (r)
  1425.      This option disables TbDriver and will try to remove the resident part
  1426.      of its code from memory in an attempt to restore this memory space back
  1427.      to the system. Unfortunately, this can work only if TbDriver was loaded
  1428.      last. An attempt to remove a TSR after another TSR has been started will
  1429.      simply leave a useless gap in memory and could disrupt the interrupt
  1430.      chain. TbDriver checks whether it is safe to remove its resident code;
  1431.      if not, it will simply disable itself. 
  1432.  
  1433.      mode (m)
  1434.      On dual video systems TbDriver will use the currently active screen. It
  1435.      may be forced to use the alternate screen with option 'mode=m' for
  1436.      monochrome, or 'mode=c' for color systems.
  1437.  
  1438.      noavok (o)
  1439.      This option is not recommended for normal usage. You may need it in
  1440.      order to grant permission automatically for programs without an Anti-
  1441.      Vir.Dat record. Option 'noavok' requires a parameter specifying the
  1442.      drives to which the default permission applies. If, for example, you do
  1443.      not want a message from TbMem when a TSR without Anti-Vir.Dat record is
  1444.      executed from drive G: and H:, you could specify 'noavok=gh' on the
  1445.      TbDriver command line.
  1446.  
  1447.      quiet (q)
  1448.      Some resident TBAV utilities display an activity status. TbScanX, for
  1449.      instance, displays a rectangle with "*Scanning*" in the upper left
  1450.      corner of your screen while scanning a file. You can disable this with
  1451.      the 'quiet' option when TbDriver is loaded.
  1452.  
  1453.      secure (s)
  1454.      Some ThunderBYTE utilities are able to store permission flags in the
  1455.      Anti-Vir.Dat files. If you don't want these flags to be changed, specify
  1456.      this option. It has no effect on flags that are already set, so the
  1457.      option 'secure' may be used after installing new programs or packages.
  1458.  
  1459.      notunnel (t)
  1460.      TbDriver normally detects tunneling attempts on the part of viruses.
  1461.      'Tunneling' is a technique viruses apply to determine the location of
  1462.      the DOS system code in memory, and to use that address to communicate
  1463.      with DOS directly. This will inactivate all TSR programs, including
  1464.  
  1465.                                       I - 19
  1466. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1467.  
  1468.  
  1469.      resident anti-virus software. TbDriver is able to detect 'tunneling'
  1470.      attempts, and informs you about this. Some other anti-virus products
  1471.      also rely on tunneling techniques to bypass resident viruses, causing
  1472.      false alarms. If you are currently executing other anti-viral products,
  1473.      option 'notunnel' will disable tunneling detection.
  1474.  
  1475.  
  1476. 4.3. Language support
  1477.  
  1478.      The optional filename specification is used to determine where the
  1479.      language file can be found. TbDriver retrieves pop-up window messages
  1480.      from a TBDRIVER.LNG file, which it expects to find in its own home
  1481.      directory. The default English language file is TBDRIVER.LNG, which may
  1482.      be replaced by a file in your local language. You can order separate
  1483.      language support packages at your local ThunderBYTE dealer, or download
  1484.      the language file from a ThunderBYTE support BBS. Please refer to page
  1485.      I-38 for further details. To load a localized language file, either
  1486.      rename it to the default original, or specify the full path and filename
  1487.      following the command. You may also switch to another language by
  1488.      calling TbDriver again with a different message file. This will not take
  1489.      up any extra memory.
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.                                       I - 20
  1523. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1524.  
  1525.  
  1526. 5. System maintenance
  1527.  
  1528.      All systems need maintenance and so do the TBAV utilities. As new
  1529.      viruses emerge, TbScan's signature file must be updated to avert new
  1530.      dangers. You may either get the latest signature file from your local
  1531.      ThunderBYTE dealer or download the file from one of our support Bulletin
  1532.      Board Systems.
  1533.  
  1534.      Whenever you add, update or replace programs on your system, be sure to
  1535.      use TbSetup to generate or update their fingerprints in the Anti-Vir.Dat
  1536.      files. Sometimes you will want to create a new recovery diskette. When
  1537.      you install a new version of DOS, the bootsector will be different.
  1538.      Changing the configuration of your hard disks may affect the partition
  1539.      tables and the CMOS setup. You should prepare a new recovery diskette
  1540.      after all system modifications.
  1541.  
  1542.  
  1543.      Updates
  1544.  
  1545.      The ThunderBYTE Anti-Virus utilities are updated at frequent intervals.
  1546.      Subscription to the ThunderBYTE update service (at your local dealer)
  1547.      guarantees delivery of each new update. You may download new revisions
  1548.      any time from any ThunderBYTE support BBS. Or check with a local bulle-
  1549.      tin board regularly, as many of them offer updated versions of our
  1550.      software.
  1551.  
  1552.      The standard complete release is issued in an archive named:
  1553.      TBAVxxx.ZIP, where 'xxx' stands for the three-digit version number. The
  1554.      archive extension may vary on local bulletin boards using a different
  1555.      archive method. To minimize download costs we also distribute smaller
  1556.      upgrade archives with only the files that have been changed since the
  1557.      previous official release. Upgrade archives have a 'U' in the filename,
  1558.      such as  TBAVUxxx.ZIP.
  1559.  
  1560.      In order to maintain the highest reliability, the Dutch and US Thunder-
  1561.      BYTE support sites issue regular beta releases, also containing only the
  1562.      files that have been changed. Beta versions can be identified by a 'B'
  1563.      in the filename, such as TBAVBxxx.ZIP.
  1564.  
  1565.      The resident ThunderBYTE Anti-Virus utilities are also available in
  1566.      processor optimized formats. These processor optimized versions, named
  1567.      TBAVXxxx.ZIP, are for registered users only. You can purchase these
  1568.      versions via your local ThunderBYTE dealer.
  1569.  
  1570.  
  1571.      Distribution of the signature file
  1572.  
  1573.      The signature file (TBSCAN.SIG) is updated frequently. It will be
  1574.      distributed via the ThunderBYTE dealers and via several Bulletin Board
  1575.      Systems. The BBS file is stored in an archive called TBSG###%.ZIP (### =
  1576.      release sequence number, % = sub-release eg. TBSG604b.ZIP). Most Bulle-
  1577.      tin Board Systems will get a fresh copy of this file within 48 hours
  1578.  
  1579.                                       I - 21
  1580. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1581.  
  1582.  
  1583.      after the master copy has been updated at Thunderbyte support BBS in The
  1584.      Netherlands. The most recent signature files can also be obtained from
  1585.      any other Thunderbyte support BBS.
  1586.  
  1587.  
  1588.      Language support
  1589.  
  1590.      The ThunderBYTE Anti-Virus utilities currently support several langua-
  1591.      ges, by means of separate language files. Check your local ThunderBYTE
  1592.      dealer for the availability of the TBAV support file in your language.
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.                                       I - 22
  1637. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1638.  
  1639.  
  1640. 6. Network maintenance
  1641.  
  1642.      The signature file TbScan.Sig should be replaced frequently. This can be
  1643.      a lot of work if you want to update all work stations on a network
  1644.      manually. Fortunately, there are several possibilities to do this job
  1645.      automatically.
  1646.  
  1647.  
  1648. 6.1. Using DOS REPLACE
  1649.  
  1650.      Maintain a directory \TBAV_UPD\ on a public server drive. Any new
  1651.      version of the TBAV utilities or any new signature file TbScan.Sig
  1652.      should be placed it in this directory.
  1653.  
  1654.      The work stations should execute a batch file automatically after users
  1655.      log in on the network. This batch file should contain the following
  1656.      lines:
  1657.  
  1658.           rem Update the anti-virus product if a new one is available.
  1659.           replace x:\tbav_upd\*.* c:\tbav /u /r
  1660.  
  1661.      'Replace' is a standard DOS utility. It copies the files specified by
  1662.      the first parameter ONLY if they are newer than the files specified in
  1663.      the second parameter.
  1664.  
  1665.      Make sure the 'replace' command is in the current path, and that the
  1666.      specified paths are valid for your configuration. The 'x', used in the
  1667.      above example, denotes the drive specification.
  1668.  
  1669.      Thus, you only have to update one drive with the new signature file or
  1670.      anti-virus software, and all workstations will update themselves as soon
  1671.      as they log in! You can also add the /S option if you want REPLACE to
  1672.      scan all directories on the workstations' drives for matching files.
  1673.      Please consult the DOS manual for more details.
  1674.  
  1675. =>   Note: Do not forget to execute TbSetup on the new utilities in the
  1676.      x:\tbav_upd directory, thus ensuring that the REPLACE command also
  1677.      copies the new Anti-Vir.Dat file.
  1678.  
  1679.  
  1680. 6.2. Using PkUnZip
  1681.  
  1682.      Maintain a directory \TBAV_UPD\ on a public server drive. Any new
  1683.      version of the TBAV distribution archive should be placed in this
  1684.      directory.
  1685.  
  1686.      The work stations should execute a batch file automatically after users
  1687.      log in on the network. This batch file should contain the following
  1688.      lines:
  1689.  
  1690.           rem Update the anti-virus product if a new one is available.
  1691.           PkUnZip -n -o x:\tbav_upd\TBAV???.ZIP c:\tbav
  1692.  
  1693.                                       I - 23
  1694. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                 SECTION I
  1695.  
  1696.  
  1697. =>   Make sure the file PkUnZip.Exe is in the current path, and that the
  1698.      paths specified are valid for your configuration.
  1699.  
  1700.      Following this procedure, the 'PkUnZip' command will only come into
  1701.      action when you just updated the ZIP files in the x:\tbav_upd directory.
  1702.      Now you only have to update one drive with the new anti-virus software,
  1703.      and all workstations will update themselves as soon as they log in!
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.                                       I - 24
  1751. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION II
  1752.  
  1753.  
  1754. SECTION II. ANTI-VIRUS STRATEGY
  1755.  
  1756. 1. Protection against viruses
  1757.  
  1758. 1.1. Introduction
  1759.  
  1760.      Maintaining a reliable safety system implies that you will be active in
  1761.      taking measures to protect your system from virus infection, since some
  1762.      viruses can hide themselves perfectly once resident in memory. At least
  1763.      once every a week you should boot from a clean and write-protected
  1764.      diskette and execute TbScan.
  1765.  
  1766.      The tightness of your safety system very much depends on the amount of
  1767.      time you want to invest to let the safety measures take place and the
  1768.      vitality of the appropriate computer system. For use on a stand alone
  1769.      computer containing low risk data, in an environment with little exchan-
  1770.      ge of computer software, a daily scan will appear to be sufficient.
  1771.  
  1772.      For company use however, in a network environment where diskettes are
  1773.      exchanged frequently, where disks contain highly vulnerable information,
  1774.      where a network going 'down' means the loss of an extensive amount of
  1775.      money, protection must be as tight as the organisation can practically
  1776.      handle.
  1777.  
  1778.      Considering the above, a simple instruction on how to use the -highly
  1779.      flexible - TBAV utilities cannot be given. It all depends on your own
  1780.      demands and possibilities.
  1781.  
  1782.      Therefore, you are advised to study this manual thoroughly so you will
  1783.      be able to determine your own safety measures. To prevent viruses from
  1784.      doing any harm you should at least under-take the activities as presen-
  1785.      ted below. 
  1786.  
  1787.  
  1788. 1.2. Basic precautions
  1789.  
  1790.      1. Install TBAV on your hard disk
  1791.  
  1792.      You may customize the installation to suit your own needs. Make sure you
  1793.      use TbSetup to maintain recovery information of all executable files of
  1794.      your system! Please refer to the installation section (I) of this
  1795.      manual. 
  1796.  
  1797.      In the following examples it is assumed that all utilities are copied in
  1798.      the (default) directory named TBAV. For all example setups it is requi-
  1799.      red that TbSetup has been executed. If your system has more hard disks
  1800.      or disk partitions you should repeat the TbSetup invocation for every
  1801.      drive or partition.
  1802.  
  1803.      The example setups assume you have created a recovery diskette.
  1804.  
  1805.  
  1806.  
  1807.                                       II - 1
  1808. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION II
  1809.  
  1810.  
  1811.      The example setups outlined below are just intended to give you some
  1812.      ideas about the use of the TBAV utilities, and these examples are not
  1813.      intended as a full featured protection setup!
  1814.  
  1815.  
  1816.      2. Prepare a recovery diskette
  1817.  
  1818.      You will absolutely need a clean recovery diskette in order to be able
  1819.      to get rid of a virus at all later on. Take a few minutes to prepare one
  1820.      now well ahead of a possible future contamination when it would be too
  1821.      late. 
  1822.  
  1823.      Take a new, empty diskette, put it in drive A:, go to your DOS directory
  1824.      and execute the following commands:
  1825.  
  1826.           Format A: /S
  1827.           Copy SYS.COM A:
  1828.  
  1829.      Now return to the TBAV directory, eg.:
  1830.  
  1831.           CD \TBAV
  1832.  
  1833.      Execute the MakeResc batch file:
  1834.  
  1835.           makeresc A:
  1836.  
  1837.      The MakeResc batch file will create a reliable recovery diskette by
  1838.      creating or copying the following files.
  1839.  
  1840.      -    A backup of the bootsector, partition sector and CMOS configu-
  1841.           ration.
  1842.  
  1843.      -    A Config.Sys file, containing:
  1844.  
  1845.           Files=20
  1846.           Buffers=20
  1847.           Device=TbDriver.Exe
  1848.           Device=TbCheck.Exe FullCRC
  1849.  
  1850.      -    An Autoexec.Bat file, containing:
  1851.  
  1852.           @echo off
  1853.           echo off
  1854.           PATH=A:\
  1855.           TBAV
  1856.           Cls
  1857.           Echo Warning!!!
  1858.           Echo If you suspect a virus, do NOT execute anything
  1859.           Echo from the hard disk!
  1860.  
  1861.  
  1862.  
  1863.  
  1864.                                       II - 2
  1865. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION II
  1866.  
  1867.  
  1868.      -    The following files:
  1869.  
  1870.           TBAV.EXE
  1871.           TBAV.LNG
  1872.           TBSCAN.EXE
  1873.           TBSCAN.LNG
  1874.           TBSCAN.SIG
  1875.           TBDRIVER.EXE
  1876.           TBDRIVER.LNG
  1877.           TBCHECK.EXE
  1878.           TBCLEAN.EX
  1879.           TBUTIL.EXE
  1880.           TBUTIL.LNG
  1881.  
  1882.      Copy to the diskette any other utilities that could come in handy in an
  1883.      emergency situation, including a simple editor to edit Config.Sys and
  1884.      AutoExec.Bat files. If your hard disk needs special device drivers to
  1885.      unlock added features, such as DoubleSpace or Stacker, copy the approp-
  1886.      riate drivers to the recovery diskette and install them in the Con-
  1887.      fig.Sys file on drive A:, taking care to avoid statements that will
  1888.      access the hard disk. Be sure to check the instructions in the device
  1889.      driver's manual for the correct procedures.
  1890.  
  1891.      Make the disk write protected. Label the diskette 'Recovery' together
  1892.      with a short of the PC the diskette belongs to. Store the diskette in a
  1893.      safe place. Use it only in case of an emergency, so make a copy if you
  1894.      need a similar diskette for general purposes.
  1895.  
  1896.  
  1897.      3. Keep shady software out
  1898.  
  1899.      Many companies do not allow employees to install or execute unauthorized
  1900.      software. Or perhaps you wish to keep family members from invading your
  1901.      computer with haphazard games and sundry software. TBAV provides a
  1902.      watchdog function that can help to enforce this. First you will need to
  1903.      add the following lines to the Config.Sys file:
  1904.  
  1905.           Device=C:\TBAV\TbDriver.Exe
  1906.           Device=C:\TBAV\TbCheck.Exe secure
  1907.  
  1908.      If you have installed the TBAV Utilities using the TBAV installation
  1909.      program, you can - instead of editing the CONFIG.SYS file - adjust the
  1910.      TBSTART.BAT file, appending the 'secure' option to the TbCheck command:
  1911.  
  1912.           C:\TBAV\TbDriver
  1913.           C:\TBAV\TbCheck secure
  1914.  
  1915.      Execute TbSetup on the system:
  1916.  
  1917.           TbSetup C:\
  1918.  
  1919.  
  1920.  
  1921.                                       II - 3
  1922. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION II
  1923.  
  1924.  
  1925.      Reboot the system by pressing <Ctrl>-<Alt>-<Del>. From now on, TbCheck
  1926.      will put an effective clamp on any user who tries to execute software
  1927.      which has not been duly authorized first by TbSetup. Whenever someone is
  1928.      trying to execute an unknown program, TBAV will display the following
  1929.      message:
  1930.  
  1931.  
  1932.      +---------- TBAV interception ---------+
  1933.      |                WARNING!              |
  1934.      | The requested program (GAME.EXE)     |
  1935.      | is not authorized and can not be     |
  1936.      | executed.                            |
  1937.      | Execution cancelled! Press any key...|
  1938.      +--------------------------------------+
  1939.  
  1940.  
  1941.      4. Restrict user access
  1942.  
  1943.      Most of the TBAV utilities are interactive. They need to communicate
  1944.      with a knowledgable user in order to establish appropriate action in
  1945.      ambiguous situations. Many companies, however, insist that the system
  1946.      operator be the sole authority allowed to communicate with TBAV and so
  1947.      avoid wrong decisions on the part of possibly inept employees. That is
  1948.      why most of TBAV utilities support the option 'secure'. When this option
  1949.      is specified, all user interaction with any of the TBAV utilities is
  1950.      suspended. In other words, users will never be queried for permission to
  1951.      allow questionable operations, avoiding erroneous decisions which may
  1952.      well result in irreparable havoc.
  1953.  
  1954.  
  1955.      5. Never use 'strange' diskettes to boot
  1956.  
  1957.      Only boot from your hard disk or from your original DOS diskette. NEVER
  1958.      use someone else's disk to boot from. Should you have a hard disk, make
  1959.      certain that you have opened the door to your floppy drive before
  1960.      resetting or booting your PC.
  1961.  
  1962.  
  1963.      6. Use ChkDsk frequently
  1964.  
  1965.      Use the DOS program ChkDsk frequently (without the /F switch). ChkDsk is
  1966.      able to detect some viruses, because such viruses change the disk
  1967.      structure in an incorrect manner, causing disk errors in the process.
  1968.      Look out for changes in the behaviour of your software or your PC. Any
  1969.      change in their behaviour is suspect, unless you know its cause. Some
  1970.      highly suspicious symptoms are:
  1971.  
  1972.      -    The amount of available memory space has decreased.
  1973.  
  1974.      -    Programs need more time to execute.
  1975.  
  1976.  
  1977.  
  1978.                                       II - 4
  1979. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION II
  1980.  
  1981.  
  1982.      -    Programs do not operate as they used to, or cause the system to
  1983.           crash or reboot after some time.
  1984.  
  1985.      -    Data disappears or gets damaged.
  1986.  
  1987.      -    The size of one or more programs has increased.
  1988.  
  1989.      -    The screen behaves strangely, or unusual information is displayed.
  1990.  
  1991.      -    ChkDsk detects many errors.
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.                                       II - 5
  2036. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION II
  2037.  
  2038.  
  2039. 2. What to do when a virus strikes
  2040.  
  2041.  
  2042. 2.1. Detection of viruses
  2043.  
  2044.      The first thing to do when you become aware that your system may have
  2045.      been infected is to back up all important files immediately. Use fresh
  2046.      backup media and do not overwrite a previous back up set. You may need
  2047.      the previous set to replace lost or contaminated files. Label the new
  2048.      backup as unreliable, as some of the files may be infected.
  2049.  
  2050.      As soon as you become aware of a virus infection it is imperative that
  2051.      you boot only from a reliable, write protected recovery system diskette.
  2052.  
  2053.  
  2054.      Know the symptoms 
  2055.  
  2056.      Next, execute TbScan for an indication about what is wrong, or boot from
  2057.      a recovery diskette and compare its system files with those on the hard
  2058.      disk to check for changes. During this test you should take care to stay
  2059.      logged on to your system diskette. 
  2060.  
  2061.      TbScan will report the virus name if the virus is known, or give a
  2062.      summary of file changes if the virus cannot be identified:
  2063.  
  2064.           TbScan C:\ logname=lpt1 log
  2065.  
  2066.      Also execute TbUtil to check the bootsector, partition code and the CMOS
  2067.      configuration.
  2068.  
  2069.           TbUtil compare
  2070.  
  2071.      Do not execute any program on your hard disk to prevent a virus from
  2072.      invading the system's memory and possibly masking the test results.
  2073.      TbCheck will warn you if you accidentially try to execute an infected or
  2074.      unauthorized program on your hard disk.
  2075.  
  2076.      Please bear in mind that it is in the nature of a file virus to infect
  2077.      as many programs as possible over a short period. You'll hardly find
  2078.      only a few infected programs on a hard disk that is in constant use. A
  2079.      TbScan virus alert flagging a mere one percent of the files on a hard-
  2080.      worked system is probably just a false alarm that has nothing to do with
  2081.      a real virus.
  2082.  
  2083.      If the file compare test indicates that all of them are still the same,
  2084.      you know at least that you are not dealing with a file virus. 
  2085.      Avoid using the same copy of the TbScan program on another system after
  2086.      discovering a virus. TbScan performs a sanity check when it fires up.
  2087.      Unfortunately there is no way to make software 100% virus-resistant. A
  2088.      sanity check does not work if a 'stealth' type of virus is involved. A
  2089.      stealth virus can hide itself completely when a self-check is being
  2090.      performed. Do note that we are not dealing with a TbScan bug here. The
  2091.  
  2092.                                       II - 6
  2093. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION II
  2094.  
  2095.  
  2096.      failure to detect stealth viruses is common to all software performing a
  2097.      sanity check. Therefore, we recommend to keep a clean version of TbScan
  2098.      on a write-protected diskette. Use this diskette to check other machines
  2099.      once you have found a virus in your own system.
  2100.  
  2101.  
  2102.      Identify the characteristics
  2103.  
  2104.      Viruses come in many different guises and have their own peculiarities.
  2105.      It is extremely important to know at the earliest possible stage which
  2106.      particular kind of virus you are dealing with. That will give you at
  2107.      least some indication of the nature and the amount of the damage it may
  2108.      have caused already. Some viruses infect only executable files that can
  2109.      easily be reinstalled or replaced from a clean source. Others swap some
  2110.      random bytes anywhere on the hard disk, which could affect data files as
  2111.      well, although the results may not be noticeable for some time. Then
  2112.      there are those that damage the hard disk partition table or file
  2113.      allocation table, while some of the even nastier ones, the multipartite
  2114.      viruses, operate in more than one area.
  2115.  
  2116.      Whatever you do, don't panic! An inexperienced user, reacting in confu-
  2117.      sion, can often create more havoc than the virus itself, such as eradi-
  2118.      cating important data in no time. While an instant reformat may get rid
  2119.      of the virus, it will definitely destroy all your recent work as well.
  2120.  
  2121.      Once isolated the virus, either contact your support BBS, consult
  2122.      literature on virus problems, or get in touch with a virus expert. 
  2123.  
  2124.  
  2125. 2.2. Recovering from viruses
  2126.  
  2127.      While recovering from a virus infection it is particularly important to
  2128.      boot only from a clean write-protected system diskette. That is the only
  2129.      way to keep a virus out of the system's memory. Never execute a program
  2130.      from the hard disk.
  2131.  
  2132.      Restore the master boot sector and the DOS system files on the hard
  2133.      disk, using the SYS command on the system diskette. If the bootsector or
  2134.      partition code contains a virus, you may also use TbUtil to get rid of
  2135.      it by restoring clean sectors:
  2136.  
  2137.           TbUtil restore
  2138.  
  2139.      Many modern hard disks, notably IDE or AT drives using advanced prefor-
  2140.      matting methods, are low-level formatted by the supplier, ready for
  2141.      partitioning and a DOS format. Do not try to low-level format these
  2142.      drives yourself. It is always better to back up the partition table with
  2143.      a utility such as TbUtil, which restores the partition table for you
  2144.      without reformatting.
  2145.  
  2146.      If the virus has been identified as a file virus, it will be safest to
  2147.      remove the infected files (by using TbDel) and to copy or reinstall all
  2148.  
  2149.                                       II - 7
  2150. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION II
  2151.  
  2152.  
  2153.      executables from a clean source. A virus cleaning utility, such as
  2154.      TbClean, won't always be able to fully restore the original program code
  2155.      and should be used only as a last resort, such as when you don't have a
  2156.      reliable backup. It may be necessary to replace data files as well if
  2157.      the virus is known to cause damage in that area. 
  2158.  
  2159.      After reassuring yourself that the system is absolutely clean again, run
  2160.      a careful check on all diskettes and backups to remove every single
  2161.      trace of the virus. Keep in mind that it takes only one infected disket-
  2162.      te to cause the same trouble all over again. 
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.                                       II - 8
  2207. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2208.  
  2209.  
  2210. SECTION III. USING THE TBAV UTILITIES
  2211.  
  2212.  
  2213. 1. TbScan
  2214.  
  2215. 1.1. The Purpose of TbScan
  2216.  
  2217.      TbScan is a virus scanner: it has been specifically developed to detect
  2218.      viruses, Trojan Horses and other such threats to your valuable data.
  2219.      Most viruses consist of a unique sequence of instructions, called a
  2220.      signature. Hence through checking for the appearance of such signatures
  2221.      in a file we can find out whether or not a program has been infected.
  2222.      Scanning all program files for the signatures of all known viruses helps
  2223.      you to find out quickly whether or not your system has been infected
  2224.      and, if so, by which virus. 
  2225.  
  2226.  
  2227.      Fast Scanning
  2228.  
  2229.      TbScan is the fastest scanner on the market today, therefore it invites
  2230.      users to invoke it from within their AUTOEXEC.BAT file every morning.
  2231.      Thanks to its design, TbScan will not slow down if the number of signa-
  2232.      tures increases. It doesn't matter whether you scan a file for 10 or a
  2233.      1000 signatures.
  2234.  
  2235.      TbScan checks itself on invocation. If it detects that it has been
  2236.      infected it aborts with an error. This minimizes the risk of transfer-
  2237.      ring a virus by the TbScan program itself and infecting your system.
  2238.  
  2239.      Heuristic Scanning
  2240.      TbScan can detect yet unknown viruses. The built-in disassembler is able
  2241.      to detect suspicious instruction sequences and abnormal program lay-
  2242.      outs. This feature is called 'heuristic scanning' and it is partially
  2243.      enabled by default. Heuristic scanning is performed on files and boots-
  2244.      ectors. 
  2245.  
  2246. =>   Note that virus scanners can only tell you whether or not your system
  2247.      has been infected and if so, if any damage has already been done. By
  2248.      that time only a non-infected backup or a recovery program such as
  2249.      TbClean can properly counter a virus infection.
  2250.  
  2251.  
  2252.      Scan Scheduling
  2253.  
  2254.      Every PC owner should use a virus scanner frequently. At least one
  2255.      should do to avoid damage caused by a virus. It is highly recommended to
  2256.      devise your own schedule for a regular scan of your system. Creating a
  2257.      special TbScan boot diskette is also recommended in this respect.
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.                                       III - 1
  2264. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2265.  
  2266.  
  2267.      The following scan sessions (listed in order of preference) are recom-
  2268.      mended:
  2269.  
  2270.      Execute TbScan from a write-protected bootable diskette once a week.
  2271.      Boot from this diskette before invoking the scanner. Booting from a
  2272.      diskette is the only way to make sure that no stealth virus will become
  2273.      resident in memory.
  2274.  
  2275.      Invoke a daily scan. You can invoke TbScan with the  'once' option from
  2276.      within the autoexec.bat file to perform the daily scan session automati-
  2277.      cally. It is not necessary to boot from the bootable TbScan diskette to
  2278.      perform the daily scan.
  2279.  
  2280.      Scan new diskettes.
  2281.  
  2282.  
  2283. 1.2. How to use Tbscan
  2284.  
  2285.      For daily use you can activate TbScan by loading the program from the
  2286.      DOS commandline (eg. in the autoexec.bat file), or via the TBAV menu.
  2287.      For weekly use, when scanning from the TbScan diskette, you could use
  2288.      the DOS command. The TbScan DOS options are listed in section 1.3. of
  2289.      this chapter.
  2290.  
  2291.  
  2292.      The 'TbScan' menu
  2293.  
  2294.      +----Main menu-----+
  2295.      |  Confi+------TbScan menu------+
  2296.      |  TbSet|  Start scanning       |
  2297.      |  TbSca|  Files/Paths to scan  |
  2298.      |  TbUti|  Options menu         |
  2299.      |  TbCLe|  Advanced options     |
  2300.      |  TBAV |  If virus found       |
  2301.      |  Docum|  Path configuration   |
  2302.      |  Quit |  Log file menu        |
  2303.      |  eXit |  View log file        |
  2304.      +-------+-----------------------+
  2305.  
  2306.  
  2307.      Files/path to scan
  2308.  
  2309.      Drive and path tell TbScan where it should perform its scanning operati-
  2310.      on. To search both disks C: and D: you should enter:
  2311.  
  2312.           C:\ D:\
  2313.  
  2314.      When no filename has been specified but a drive and/or path instead, the
  2315.      specified path will be used as top-level path. All its subdirectories
  2316.      will be processed too. If a filename is specified, only the specified
  2317.      path will be searched. Subdirectories will not be processed.
  2318.  
  2319.  
  2320.                                       III - 2
  2321. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2322.  
  2323.  
  2324.      Wildcards in the filename are allowed. You may even specify '*.*' which
  2325.      will result in all files being processed.
  2326.  
  2327.  
  2328.      View log file
  2329.  
  2330.      If one of the log file options is activated (see below) you can study
  2331.      the log file using this option. 
  2332.  
  2333.  
  2334.      The 'TbScan options' menu
  2335.  
  2336.      +----Main menu-----+
  2337.      |  Confi+------TbScan menu------+
  2338.      |  TbSet|  Start+-----TbScan options------+
  2339.      |  TbSca|  Files|  Use TBAV.INI file      |
  2340.      |  TbUti|  Optio|  Prompt for pause       |
  2341.      |  TbCLe|  Advan|  Quick scan             |
  2342.      |  TBAV |  If vi|  Non-executable scan    |
  2343.      |  Docum|  Log f|  Maximum Compatibility  |
  2344.      |  Quit |  View |v Bootsector scan        |
  2345.      |  eXit +-------|v Memory scan            |
  2346.      +---------------|  HMA scan forced        |
  2347.                      |v Upper memory scan      |
  2348.                      |v Sub-Directory scan     |
  2349.                      |  Repeat scanning        |
  2350.                      |v Abort on Ctrl-Break    |
  2351.                      +-------------------------+
  2352.  
  2353.  
  2354.      Use TBAV.INI file
  2355.  
  2356.      TbScan searches for a file named TBAV.INI in the TbScan directory. By
  2357.      enabling this option, the TbScan configuration values, saved in the
  2358.      TBAV.INI file, will also be valid when loading TbScan from the command
  2359.      line. Be careful, since options specified in the TBAV.INI file can not
  2360.      be undone on the command line. See chapter I-2 ('Configuration').
  2361.  
  2362.  
  2363.      Prompt for pause
  2364.  
  2365.      When you activate the 'pause' option TbScan will stop after it has
  2366.      checked the contents of one window. This gives you the possibility to
  2367.      examine the results without having to consult a log file afterwards.
  2368.  
  2369.  
  2370.      Quick scan
  2371.  
  2372.      TbScan will use the Anti-Vir.Dat files to check for file changes since
  2373.      the last time. Only if a file has been changed (CRC change) or is not
  2374.      yet listed in Anti-Vir.Dat it will be scanned. Normally TbScan will
  2375.      always scan files.
  2376.  
  2377.                                       III - 3
  2378. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2379.  
  2380.  
  2381.  
  2382.      Non-executable scan 
  2383.  
  2384.      With this option TbScan will scan non-executable files (files without
  2385.      extension COM, EXE, SYS or BIN) too. If TbScan finds out that such a
  2386.      file does not contain anything that can be executed by the processor the
  2387.      file will be 'skipped'. Otherwise the file will be searched for COM, EXE
  2388.      and SYS signatures. TbScan however will not perform heuristic analysis
  2389.      on non-executable files. Since viruses normally do not infect non-
  2390.      executable files it is not necessary to scan non-executable files too.
  2391.      We even recommend not to use this option unless you have a good reason
  2392.      to scan all files.
  2393.  
  2394.      Once again: a virus needs to be executed to perform what it is program-
  2395.      med to do, and since non-executable files will not be executed a virus
  2396.      in such a file can not do anything. For this reason viruses do not even
  2397.      try to infect such files. Some viruses however will write to non-execu-
  2398.      table files as a result of 'incorrect' programming. If so, these non-
  2399.      executable files will never harm other program or data files, but do
  2400.      contain corrupted data.
  2401.  
  2402.  
  2403.      Maximum compatibility 
  2404.  
  2405.      If you select this option, TbScan attempts to be more compatible with
  2406.      your system. Use this option if the program does not behave as you would
  2407.      expect, or even halts the system. This option will slow down the scan-
  2408.      ning process. Therefore, it should only be used if necessary. 
  2409. =>   Note that this option does not affect the results of a scan.
  2410.  
  2411.  
  2412.      Bootsector scan 
  2413.  
  2414.      Enabling this option will force TbScan to scan the bootsector as well.
  2415.  
  2416.  
  2417.      Memory scan 
  2418.  
  2419.      Enabling this option will force TbScan to scan the memory of the PC.
  2420.  
  2421.  
  2422.      HMA scan forced 
  2423.  
  2424.      TbScan detects the presence of an XMS-driver, and scans HMA automa-
  2425.      tically. If you have an HMA-driver which is not compatible with the XMS
  2426.      standard you can use the 'HMA' option to force TbScan to scan HMA.
  2427.  
  2428.  
  2429.      Upper memory scan 
  2430.  
  2431.      By default TbScan identifies RAM beyond the DOS limit and scans that
  2432.      too. This means that video memory and the current EMS pages are scanned
  2433.  
  2434.                                       III - 4
  2435. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2436.  
  2437.  
  2438.      by default. You can use this option to enable the scanning of non-DOS
  2439.      memory.
  2440.  
  2441.  
  2442.      Subdirectory scan 
  2443.  
  2444.      By default TbScan will search sub-directories for executable  files,
  2445.      unless a filename (wildcards allowed!) is specified. If you disable this
  2446.      option, TbScan will not scan sub-directories.
  2447.  
  2448.  
  2449.      Repeat scanning
  2450.  
  2451.      This option is very useful if you want to check a large amount of
  2452.      diskettes. TbScan does not return to DOS after checking a disk, but it
  2453.      prompts you to insert another disk in the drive.
  2454.  
  2455.  
  2456.  
  2457.      The 'TbScan advanced options' menu
  2458.  
  2459.      +----Main menu-----+
  2460.      |  Confi+------TbScan menu------+
  2461.      |  TbSet|  Start+----TbScan advanced options----+
  2462.      |  TbSca|  Files|  Full heuristic scan          |
  2463.      |  TbUti|  Optio|  Extract signatures           |
  2464.      |  TbCLe|  Advan|v Auto heuristic level adjust  |
  2465.      |  TBAV |  If vi+-------------------------------+
  2466.      |  Docum|  Path configuration  >|
  2467.      |  Quit |  Log file menu       >|
  2468.      |  eXit |  View log file        |
  2469.      +-------+-----------------------+
  2470.  
  2471.  
  2472.      Full heuristic scan 
  2473.  
  2474.      TbScan always performs a heuristic scan on the files being processed.
  2475.      However, only if a file is very probably infected with a virus, TbScan
  2476.      will report the file as being infected. If you use option 'heuristic',
  2477.      TbScan is somewhat more sensitive. In this mode 90% of the new, unknown,
  2478.      viruses will be detected without any signature, but some false alarms
  2479.      may occur. Consult also section 'Heuristic scanning' of this chapter
  2480.      (3.1).
  2481.  
  2482.  
  2483.      Extract signatures 
  2484.  
  2485.      This option is available to registered users only. See the chapter
  2486.      'TbGensig' (IV-5) on how to use the option 'extract'.
  2487.  
  2488.  
  2489.  
  2490.  
  2491.                                       III - 5
  2492. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2493.  
  2494.  
  2495.      Auto heuristic level adjust 
  2496.  
  2497.      TbScan automatically adjusts the heuristic detection level after a virus
  2498.      has been found. This provides you maximum detection capabilities in case
  2499.      you need it, while the amount of false alarms due to heuristics remains
  2500.      small in normal situations. In other words: as soon as a virus has been
  2501.      found, TbScan will anticipate and proceed as if option 'heuristic' has
  2502.      been specified.
  2503.  
  2504.  
  2505.      The 'If virus found' menu
  2506.  
  2507.      In this menu, you can configure the actions TbScan should take, if
  2508.      detecting a virus.
  2509.  
  2510.  
  2511.      +----Main menu-----+
  2512.      |  Confi+------TbScan menu------+
  2513.      |  TbSet|  Start+--What if a virus is found?--+
  2514.      |  TbSca|  Files|v Present action menu        |
  2515.      |  TbUti|  Optio|  Just continue (log only)   |
  2516.      |  TbCLe|  Advan|  Delete infected file       |
  2517.      |  TBAV |  If vi|  Rename infected file       |
  2518.      |  Docum|  Log f+-----------------------------+
  2519.      |  Quit |  View log file        |
  2520.      |  eXit +-----------------------+
  2521.      +------------------+
  2522.  
  2523.  
  2524.      Present action menu
  2525.  
  2526.      If TbScan detects a virus, the program will display a menu containing
  2527.      the possible actions to be taken: just continu, delete or rename the
  2528.      infected file.
  2529.  
  2530.  
  2531.      Just continue (log only) 
  2532.  
  2533.      If TbScan detects an infected file it prompts the user to delete or
  2534.      rename the infected file, or to continue without action. If you select
  2535.      this option, TbScan will always continue. We highly recommend you to use
  2536.      a log file in such situations, as a scanning operation does not make
  2537.      much sense without the return messages being read (see 'Command line
  2538.      options').
  2539.  
  2540.  
  2541.      Delete infected file 
  2542.  
  2543.      If TbScan detects a virus in a file it prompts the user to delete or
  2544.      rename the infected file, or to continue without action. If you specify
  2545.      the 'delete' option, TbScan will delete the infected file automatically,
  2546.      without prompting the user first. Use this option if you have determined
  2547.  
  2548.                                       III - 6
  2549. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2550.  
  2551.  
  2552.      it is a virus infection. Make sure that you have a clean back-up, and
  2553.      that you really want to get rid of all infected files at once.
  2554.  
  2555.  
  2556.      Rename infected file 
  2557.  
  2558.      If TbScan detects a file virus it prompts the user to delete or rename
  2559.      the infected file, or to continue without action. If you select the
  2560.      'rename' option, TbScan will rename the infected file automatically,
  2561.      without prompting the user first. By default, the first character of the
  2562.      file extension will be replaced by the character 'V'. An .EXE file will
  2563.      be renamed to .VXE, and a .COM file to .VOM. This prevents the infected
  2564.      programs from being executed, spreading the infection. At the same time
  2565.      they can be kept for later examination and repair.
  2566.  
  2567.  
  2568.  
  2569.      The 'TbScan LOG' menu
  2570.  
  2571.      +----Main menu-----+
  2572.      |  Confi+------TbScan menu------+
  2573.      |  TbSet|  Start+-------TbScan LOG menu-------+
  2574.      |  TbSca|  Files|  Output to log file         |
  2575.      |  TbUti|  Optio|  Log file path/name         |
  2576.      |  TbCLe|  Advan|  Specify log-level         >|
  2577.      |  TBAV |  If vi|  Append to existing log     |
  2578.      |  Docum|  Log f|  No heuristic descriptions  |
  2579.      |  Quit |  View +-----------------------------+
  2580.      |  eXit +-----------------------+
  2581.      +------------------+
  2582.  
  2583.  
  2584.      Output to logfile 
  2585.  
  2586.      When you use this option, TbScan creates a log file. The log file lists
  2587.      all infected program files, specifying heuristic flags (see: appendix B)
  2588.      and complete pathnames.
  2589.  
  2590.  
  2591.      Log file path/name 
  2592.  
  2593.      With option logname you can specify the name of the log file to be used.
  2594.      TbScan will create the file in the current directory unless you specify
  2595.      a path and filename after selecting this option. If the log file already
  2596.      exists, it will be overwritten. If you want to print the results, you
  2597.      can specify a printer device name rather than a filename (logname=lpt1).
  2598. =>   Note: you have to combine this option with option 'log'. 
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.                                       III - 7
  2606. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2607.  
  2608.  
  2609.      Append to existing log 
  2610.  
  2611.      If you use this option, TbScan will not overwrite an existing log file
  2612.      but append the new information to it. If you use this option often, it
  2613.      is recommended to delete or truncate the log file once in a while to
  2614.      avoid unlimited growth.
  2615. =>   Note: you have to combine this option with option 'log'. 
  2616.  
  2617.  
  2618.      No heuristic descriptions 
  2619.  
  2620.      If you enable this option TbScan will not specify the descrip-tions of
  2621.      the heuristic flags in the log file. The heuristic flag descriptions are
  2622.      listed in appendix B.
  2623.  
  2624.  
  2625.      The 'LOG level' menu
  2626.  
  2627.      +----Main menu-----+
  2628.      |  Confi+------TbScan menu------+
  2629.      |  TbSet|  Start+-------TbScan LOG menu-------+
  2630.      |  TbSca|  Files|  Log f+--------Log-level menu--------+
  2631.      |  TbUti|  Optio|  Outpu|  0: Log only infected files  |
  2632.      |  TbCLe|  Advan|  Speci|v 1: Log summary too          |
  2633.      |  TBAV |  If vi|  Appen|  2: Log suspected too        |
  2634.      |  Docum|  Log f|  No he|  3: Log all warnings too     |
  2635.      |  Quit |  View +-------|  4: Log clean files too      |
  2636.      |  eXit +---------------+------------------------------+
  2637.      +------------------+
  2638.  
  2639.  
  2640.      Loglevel 
  2641.  
  2642.      These levels determine what kind of file information will be stored in
  2643.      the log file. The default log level is 1. You may select one of five log
  2644.      levels:
  2645.  
  2646.      0    Log only infected files. If there are no infected files do not
  2647.           create or change the log file.
  2648.  
  2649.      1    Log summary too. Put a summary and timestamp in the log file. Put
  2650.           only infected files in the log file.
  2651.  
  2652.      2    Log suspected too. Same as loglevel=1, but now also 'suspected'
  2653.           files are logged. Suspected files are files that would trigger the
  2654.           heuristic alarm if option 'heuristic' had been specified.
  2655.  
  2656.      3    Log all warnings too. Same as loglevel=2, but all files that have a
  2657.           warning character printed behind the filename will be logged too.
  2658.  
  2659.      4    Log clean files too. All files being processed will be put into the
  2660.           log file.
  2661.  
  2662.                                       III - 8
  2663. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2664.  
  2665.  
  2666.  
  2667. 1.3. Command line options
  2668.  
  2669.      When loaded from the DOS command line, Tbscan recognizes option short-
  2670.      keys and option words. The words are easier to memorize, and they will
  2671.      be used in this manual for convenience. TbScan searches for a file named
  2672.      TBAV.INI in the TbScan directory. 
  2673.  
  2674.      If the keyword 'UseIni' is specified in the [TbScan] section of the
  2675.      TBAV.INI file, the options will also be valid when TbScan is invoked
  2676.      from the command line. Be careful, as options specified in the TBAV.INI
  2677.      file can not be undone on the command line.
  2678.  
  2679.  
  2680.      option parameter        short  explanation
  2681.      -----------------------------------------------------------------
  2682.      help                    he     help 
  2683.      pause                   pa     enable 'Pause' prompt
  2684.      mono                    mo     force monochrome
  2685.      quick                   qs     quick scan (uses Anti-Vir.Dat)
  2686.      allfiles                af     scan non-executable files too
  2687.      heuristic               hr     enable heuristic alerts
  2688.      extract                 ex     extract signature (registered only)
  2689.      once                    oo     only once a day
  2690.      secure                  se     user abort not allowed (reg. only)
  2691.      compat                  co     maximum-compatibility mode
  2692.      ignofile                in     ignore no-file-error
  2693.      noboot                  nb     skip bootsector check
  2694.      nomem                   nm     skip memory check
  2695.      hma                     hm     force HMA scan
  2696.      nohmem                  nh     skip UMB/HMA scan
  2697.      nosub                   ns     skip sub-directories
  2698.      noautohr                na     auto heuristic level adjust
  2699.      repeat                  rp     scan multiple diskettes
  2700.      batch                   ba     batch mode. No user input
  2701.      delete                  de     delete infected files
  2702.      log                     lo     output to logfile
  2703.      append                  ap     log file append mode
  2704.      expertlog               el     no heuristic descriptions in log 
  2705.  
  2706.      logname  =<filename>    ln     set path/name of log file
  2707.      loglevel =<0..4>        ll     set log level
  2708.      rename   [=<text-mask>] rn     rename infected files
  2709.  
  2710.  
  2711.      You can find an explanation on most of the command line options at the
  2712.      similar menu descriptions presented above. 
  2713.  
  2714.      help (he)
  2715.      If you specify this option TbScan will display the help as listed above.
  2716.  
  2717.  
  2718.  
  2719.                                       III - 9
  2720. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2721.  
  2722.  
  2723.      pause (pa)
  2724.      When you activate the 'pause' option TbScan will stop after it has
  2725.      checked the contents of one window. This gives you the possibility to
  2726.      examine the results without having to consult a log file afterwards.
  2727.  
  2728.      mono (mo)
  2729.      This option forces TbScan to refrain from using colors in the screen
  2730.      output. This might enhance the screen output on some LCD screens or
  2731.      color-emulating monochrome systems.
  2732.  
  2733.      quick (qs)
  2734.      TbScan will use the Anti-Vir.Dat files to check for file changes since
  2735.      the last time only. Only if a file has been changed (CRC change) or is
  2736.      not yet listed in Anti-Vir.Dat it will be scanned. Normally TbScan will
  2737.      always scan files.
  2738.  
  2739.      allfiles (af)
  2740.      With this option TbScan will scan non-executable files (files without
  2741.      extension COM, EXE, SYS or BIN) too. If TbScan finds out that such a
  2742.      file does not contain anything that can be executed by the processor the
  2743.      file will be 'skipped'. Otherwise the file will be searched for COM, EXE
  2744.      and SYS signatures. TbScan however will not perform heuristic analysis
  2745.      on non-executable files.
  2746.  
  2747.      Since viruses normally do not infect non-executable files it is not
  2748.      necessary to scan non-executable files too. We even recommend not to use
  2749.      this option unless you have a good reason to scan all files. Once again:
  2750.      a virus needs to be executed to perform what it is programmed to do, and
  2751.      since non-executable files will not be executed a virus in such a file
  2752.      can not do anything. For this reason viruses do not even try to infect
  2753.      such files. Some viruses however will write to non-executable files as a
  2754.      result of 'incorrect' programming. If so, these non-executable files
  2755.      will never harm other program or data files, but do contain corrupted
  2756.      data.
  2757.  
  2758.      heuristic (hr)
  2759.      TbScan always performs a heuristic scan on the files being processed.
  2760.      However, only if a file is very probably infected with a virus, TbScan
  2761.      will report the file as being infected. If you use option 'heuristic',
  2762.      TbScan is somewhat more sensitive. In this mode 90% of the new, unknown,
  2763.      viruses will be detected without any signature, but some false alarms
  2764.      may occur. Consult also section 'Heuristic scanning' of this chapter
  2765.      (3.1). 
  2766.  
  2767.      extract (ex)
  2768.      This option is available to registered users only. See the chapter
  2769.      'TbGensig' (IV-5) on how to use the option 'extract'. 
  2770.  
  2771.      once (oo)
  2772.      If you specify this option TbScan will 'remember' after its scan that is
  2773.      has been executed that day, and that it should not be executed again the
  2774.      same day with this particular option set. This option is very useful if
  2775.  
  2776.                                      III - 10
  2777. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2778.  
  2779.  
  2780.      you incorporate it in your AUTOEXEC.BAT file in combination with a list
  2781.      file:
  2782.           TbScan @Everyday.Lst once rename
  2783.  
  2784.      TbScan will now scan the list of files and/or paths specified in the
  2785.      file EVERYDAY.LST during the first boot-up of the day. 
  2786.  
  2787.      If the systems boots more often that day, TbScan will then return to DOS
  2788.      immediately.  This option does not interfere with the regular use of
  2789.      TbScan. If you invoke TbScan without the 'once' option it will always be
  2790.      executed, regardless of a previous run with the 'once' option set.
  2791.  
  2792. =>   Note that if TbScan cannot write to TBSCAN.EXE because it has been
  2793.      flagged 'read-only' or is located on a write-protected diskette, the
  2794.      'once' option will fail and the scanner will be executed without it.
  2795.  
  2796.      secure (se)
  2797.      This option is available to registered users only. If this option is
  2798.      specified it is no longer possible to cancel TbScan by pressing Ctrl-
  2799.      Break, or to respond to a virus alert window.
  2800.  
  2801.      compat (co)
  2802.      If you select this option, TbScan attempts to be more compatible with
  2803.      your system. Use this option if the program does not behave as you would
  2804.      expect, or even halts the system. This option will slow down the scan-
  2805.      ning process. Therefore, it should only be used if necessary. 
  2806.      Note that this option does not affect the results of a scan.
  2807.  
  2808.      ignofile (in)
  2809.      If this option is specified and no files can be found, TbScan will not
  2810.      display the 'no files found' message, nor does it exit with errorlevel
  2811.      1. This option might be useful for automatic contents scanning.
  2812.  
  2813.      noboot (nb)
  2814.      If you specify this option TbScan will not scan the bootsector.
  2815.  
  2816.      nomem (nm)
  2817.      If you specify this option TbScan will not scan the memory of the PC for
  2818.      viruses.
  2819.  
  2820.      hma (hm)
  2821.      TbScan detects the presence of an XMS-driver, and scans HMA automa-
  2822.      tically. If you have an HMA-driver which is not compatible with the XMS
  2823.      standard you can use the 'HMA' option to force TbScan to scan HMA.
  2824.  
  2825.      nohmem (nh)
  2826.      By default TbScan identifies RAM beyond the DOS limit and scans that
  2827.      too. This means that video memory and the current EMS pages are scanned
  2828.      by default. You can use this option to disable the scanning of non-DOS
  2829.      memory.
  2830.  
  2831.  
  2832.  
  2833.                                      III - 11
  2834. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2835.  
  2836.  
  2837.      nosub (ns)
  2838.      By default TbScan will search sub-directories for executable  files,
  2839.      unless a filename (wildcards allowed!) is specified. If you enable this
  2840.      option, TbScan will not scan sub-directories.
  2841.  
  2842.      noautohr (na)
  2843.      TbScan automatically adjusts the heuristic detection level after a virus
  2844.      has been found. This provides you maximum detection capabilities in case
  2845.      you need it, while the amount of false alarms due to heuristics remains
  2846.      small in normal situations. In other words: as soon as a virus has been
  2847.      found, TbScan will anticipate and proceed as if option 'heuristic' has
  2848.      been speci-fied. If you don't want this, you can specify option 'noau-
  2849.      tohr'.
  2850.  
  2851.      repeat (rp)
  2852.      This option is very useful if you want to check a large amount of
  2853.      diskettes. TbScan does not return to DOS after checking a disk, but it
  2854.      prompts you to insert another disk in the drive.
  2855.  
  2856.      batch (ba)
  2857.      By enabling this option TbScan will scan without displaying any messa-
  2858.      ges. Therefore, the use of a LOG file is highly
  2859.      advisable.
  2860.  
  2861.      delete (de)
  2862.      If TbScan detects a virus in a file it prompts the user to delete or
  2863.      rename the infected file, or to continue without action. Ifyou specify
  2864.      the 'delete' option, TbScan will delete the infected file automatically,
  2865.      without prompting the user first. Use this option if you have determined
  2866.      it is a virus infection. Make sure that you have a clean back-up, and
  2867.      that you really want to get rid of all infected files at once.
  2868.  
  2869.      log (lo)
  2870.      When you use this option, TbScan creates a log file. The log file lists
  2871.      all infected program files, specifying heuristic flags (see: appendix B)
  2872.      and complete pathnames.
  2873.  
  2874.      append (ap)
  2875.      If you use this option, TbScan will not overwrite an existing log file
  2876.      but append the new information to it. If you use this option often, it
  2877.      is recommended to delete or truncate the log file once in a while to
  2878.      avoid unlimited growth.
  2879. =>   Note: you have to combine this option with option 'log'.
  2880.  
  2881.      expertlog (el)
  2882.      If you enable this option TbScan will not specify the descriptions of
  2883.      the heuristic flags in the log file. The heuristic flag descriptions are
  2884.      listed in appendix B.
  2885.  
  2886.      logname =<filename> (ln)
  2887.      With option logname you can specify the name of the log file to be used.
  2888.      TbScan will create the file in the current directory unless you specify
  2889.  
  2890.                                      III - 12
  2891. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2892.  
  2893.  
  2894.      a path and filename after selecting this option. If the log file already
  2895.      exists, it will be overwritten. If you want to print the results, you
  2896.      can specify a printer device name rather than a filename (logname=lpt1).
  2897. =>   Note: you have to combine this option with option 'log'.
  2898.  
  2899.      loglevel =<0..4> (ll)
  2900.      These levels determine what kind of file information will be stored in
  2901.      the log file. The default log level is 1. You may select one of five log
  2902.      levels:
  2903.  
  2904.      0    Log only infected files. If there are no infected files do not
  2905.           create or change the log file.
  2906.  
  2907.      1    Log summary too. Put a summary and timestamp in the log file. Put
  2908.           only infected files in the log file.
  2909.  
  2910.      2    Log suspected too. Same as loglevel=1, but now also 'suspected'
  2911.           files are logged. Suspected files are files that would trigger the
  2912.           heuristic alarm if option 'heuristic' had been specified.
  2913.  
  2914.      3    Log all warnings too. Same as loglevel=2, but all files that have a
  2915.           warning character printed behind the filename will be logged too.
  2916.  
  2917.      4    Log clean files too. All files being processed will be put into the
  2918.           log file.
  2919.  
  2920. =>   Note: you have to combine this option with option 'log'.
  2921.  
  2922.      rename [=<text-mask>]
  2923.      If TbScan detects a file virus it prompts the user to delete or rename
  2924.      the infected file, or to continue without action. If you select the
  2925.      'rename' option, TbScan will rename the infected file automatically,
  2926.      without prompting the user first. By default, the first character of the
  2927.      file extension will be replced by the character 'V'. An .EXE file will
  2928.      be renamed to .VXE, and a .COM file to .VOM. This prevents the infected
  2929.      programs from being executed, spreading the infection. At the same time
  2930.      they can be kept for later examination and repair.
  2931.  
  2932.      You may also add a parameter to this option specifying the target
  2933.      extension. This parameter should always contain 3 characters; question
  2934.      marks are allowed. The default target extension is 'V??'.
  2935.  
  2936.  
  2937.      Examples:
  2938.           TbScan c:\ noboot 
  2939.  
  2940.      Process all executable files in the root directory and its subdirecto-
  2941.      ries. Skip the bootsector scan.
  2942.  
  2943.           TbScan \*.* 
  2944.  
  2945.      Process all files in the root directory. Don't process subdirectories.
  2946.  
  2947.                                      III - 13
  2948. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  2949.  
  2950.  
  2951.           TbScan c:\ log logname=c:\test.log loglevel=2
  2952.  
  2953.      All executable files on drive C: will be checked. A LOG file with the
  2954.      name c:\test.log will be created. The log file will contain all infected
  2955.      and suspected files.
  2956.  
  2957.           TbScan \ log logname=lpt1
  2958.  
  2959.      TbScan will scan the root directory and its subdirectories. The results
  2960.      are redirected to the printer rather than to a log file.
  2961.  
  2962.  
  2963. 1.4. The scanning process
  2964.  
  2965.      Choose the 'Start scanning' option in the TbScan menu or start the
  2966.      TbScan program from the DOS command line. TbScan will start scanning
  2967.      right away.
  2968.  
  2969.      +-----------------------------------------------------------------+
  2970.      |Thunderbyte virus detector v6.04 - (C) 1989-93, Thunderbyte B.V. |
  2971.      |                                                                 |
  2972.      | TBAV is upgraded every two months. Free hotline support is      |
  2973.      | provided for all registered users via telephone, fax and        |
  2974.      | electronic bulletin board. Read the comprehensive documentation |
  2975.      | files for detailed info. BBS: +31- 85- 212 395                  |
  2976.      |                                                                 |
  2977.      | C:\DOS\                                                         |
  2978.      | ** Unregistered evaluation version. Don't forget to register! **|
  2979.      |                                                                 |
  2980.      | ANSI.SYS      scanning..>        OK    signatures:        986   |
  2981.      | COUNTRY.SYS   skipping..>        OK                             |
  2982.      | DISKCOPY.COM  tracing...>        OK    file system:       OWN   |
  2983.      | DISPLAY.SYS   scanning..>        OK                             |
  2984.      | DRIVER.SYS    scanning..>        OK    directories:        01   |
  2985.      | EGA.CPI       skipping..>        OK    total files:        17   |
  2986.      | FASTOPEN.EXE  looking...>        OK    executables:        12   |
  2987.      | FDISK.EXE     looking...>        OK    CRC verified:       10   |
  2988.      | FORMAT.COM    tracing...>   E    OK    changed files:      00   |
  2989.      | GRAFTABL.COM  tracing...>        OK    infected items:     00   |
  2990.      | GRAPHICS.COM  tracing...>        OK                             |
  2991.      | GRAPHICS.PRO  skipping..>        OK    elapsed time:    00:05   |
  2992.      |                                        Kb /second:        57    |
  2993.      |                                                                 |
  2994.      +-----------------------------------------------------------------+
  2995.  
  2996.      TbScan divides the screen into three windows: an information window, a
  2997.      scanning window and a status window. The information window will initi-
  2998.      ally display the vendor information only. 
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.                                      III - 14
  3005. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3006.  
  3007.  
  3008.      While Scanning
  3009.  
  3010.      If TbScan detects infected files the names of the file and the virus
  3011.      will be displayed in the upper window. The lower left window displays
  3012.      the names of the files being processed, the algorithm in use, info and
  3013.      heuristic flags, and finally an OK statement or the name of the virus
  3014.      detected.
  3015.  
  3016.  
  3017.      Example: NLSFUNC.EXE     checking..>    FU          OK
  3018.                  |              |            |           |
  3019.                  |              |            |           result of scan
  3020.                  |              |            heuristic flags
  3021.                  |              algorithm being used to process file
  3022.                  name of file in process
  3023.  
  3024.  
  3025.      You will see comments following each file name: 'looking', 'checking',
  3026.      'tracing', 'scanning' or 'skipping'. These refer to the various algo-
  3027.      rithms being used to scan files.
  3028.  
  3029.      Other comments that TbScan can display here are the heuristic flags.
  3030.      Consult the 'Heuristic flags' chapter (1.3) for more information on
  3031.      these warning characters.
  3032.  
  3033.      The lower right window is the status window. It displays the number of
  3034.      files and directories encountered, the amount of viruses found. It also
  3035.      displays which file system is being used: either "DOS" or "OWN". The
  3036.      latter means that TbScan is able to bypass DOS. If this is the case,
  3037.      TbScan reads all files directly from disk for extra security and speed.
  3038.  
  3039.      The scanning process can be aborted by pressing Ctrl-Break.
  3040.  
  3041.  
  3042.      Detecting Viruses
  3043.  
  3044.      As soon as an infected program is found, TbScan will display the name of
  3045.      the virus. If you did not specify one of the  options 'batch', 'rename'
  3046.      or 'delete', TbScan will prompt you to specify the appropriate action.
  3047.      If you choose to rename the file, the first character of the file
  3048.      extension will be replaced by the character 'V'. This prevents the file
  3049.      from being executed by accident before it has been investigated more
  3050.      thoroughly. 
  3051.  
  3052.  
  3053.      If an infected file is detected, TbScan will display a message:
  3054.  
  3055.           Infected by [name of virus] virus.
  3056.           The file is infected by the virus mentioned.
  3057.  
  3058.  
  3059.  
  3060.  
  3061.                                      III - 15
  3062. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3063.  
  3064.  
  3065.           Is Joke named [name of Joke]  
  3066.           There are some programs which simulate that the system is infected
  3067.           by a virus. A joke is completely harmless.
  3068.  
  3069.           Is Trojan named [name of Trojan]
  3070.           The file is a Trojan Horse.Do not execute the program but delete
  3071.           it.
  3072.  
  3073.           Damaged by [name of virus]
  3074.           A damaged file contains - unlike an infected file - not the virus
  3075.           itself, but has been damaged by the virus.
  3076.  
  3077.           Dropper of [name of virus]
  3078.           A dropper is a program that has not been infected itself, but which
  3079.           does contain a bootsector virus and is able to install it in your
  3080.           bootsector.
  3081.  
  3082.           Overwritten by [name of virus]
  3083.           Some viruses overwrite files. An overwritten file contains - unlike
  3084.           an infected file - not the virus itself, but has been overwritten
  3085.           with garbage.
  3086.  
  3087.      It is also possible that TbScan encounters a file that seems to be
  3088.      infected by a virus, although a signature could not be found. In this
  3089.      case TbScan displays the prefix 'Probably' before the message. 
  3090.  
  3091.  
  3092.      Program Validation
  3093.  
  3094.      If TbScan finds a file to be very suspicious and pops up with the virus
  3095.      alert window, you can avoid future false alarms by pressing 'V' (Valida-
  3096.      te program). Note that this only works if there is an Anti-Vir.Dat
  3097.      record of the file available. Once a program is validated it will no
  3098.      longer be subject to heuristic analysis, unless the program changes and
  3099.      does not match the Anti-Vir.Dat record anymore. This will be the case if
  3100.      such a file gets infected afterwards, so TbScan will still report
  3101.      infections on these files.
  3102.  
  3103. =>   Note that a validated program is still subject to the conventional
  3104.      signature scanning.
  3105.  
  3106.  
  3107.      Heuristic Scanning
  3108.  
  3109.      If you have specified the option 'heuristic' it is likely that TbScan
  3110.      will find some files which look like a virus, and in this case TbScan
  3111.      uses the prefix 'Might be' to inform you about it. So, if TbScan dis-
  3112.      plays: 
  3113.  
  3114.           Probably infected by an unknown virus (level 1)
  3115.      or:
  3116.           Might be infected by an unknown virus (level 2) 
  3117.  
  3118.                                      III - 16
  3119. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3120.  
  3121.  
  3122.      it does not necessarily mean that the file is infected. There are a lot
  3123.      of files that look like a virus but are not.
  3124.  
  3125. =>   The heuristic levels are explained in section IV (page 9).
  3126.  
  3127.  
  3128.      False Positives
  3129.  
  3130. =>   Important!
  3131.      False alarms are part of the nature of heuristic scanning. In default
  3132.      mode it is very unlikely that TbScan issues a false alarm. However, if
  3133.      you have specified option 'heuristic' some false alarms might occur. How
  3134.      to deal with these false alarms? If TbScan thinks it has found a virus
  3135.      it tells you the reason for this suspicion. In most cases you will be
  3136.      able to evaluate these reasons when you consider the purpose of the
  3137.      suspected file.
  3138.  
  3139. =>   Note that viruses infect other programs. It is highly unlikely that you
  3140.      will find only a few infected files on a hard disk used frequently. You
  3141.      should ignore the result of a heuristic scan if only a few programs on
  3142.      your hard disk trigger it. But, if your system behaves in a 'strange'
  3143.      manner and many programs cause TbScan to issue an alarm with the same
  3144.      serious flags, your system could very well be infected by a (yet un-
  3145.      known) virus.
  3146.  
  3147.  
  3148.      Heuristic flags
  3149.  
  3150.      Heuristic flags consist of single characters that are printed behind the
  3151.      name of the file that has been processed. There are two kinds of flags:
  3152.      the informative ones are printed in lower-case characters; the more
  3153.      serious flags are printed in upper-case characters. 
  3154.  
  3155.      The lower-case flags are indicative of special characteristics of the
  3156.      file being processed, whereas the upper-case warnings may indicate a
  3157.      virus. If the 'loglevel' is 3 or above, the important warnings will not
  3158.      only appear as a warning character, but there will also be a description
  3159.      printed in the log file.
  3160.  
  3161.      How should you treat the flags? The less important lower-case flags can
  3162.      be considered to be for your information only.They provide you with file
  3163.      information you might find interesting. The more serious warning flags
  3164.      printed in upper-case MIGHT point towards a virus. It is quite normal
  3165.      that you have some files in your system which trigger an upper-case
  3166.      flag.
  3167.  
  3168.      The heuristic flag descriptions are listed in appendix B.
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.                                      III - 17
  3176. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3177.  
  3178.  
  3179. 2.  TbScanX
  3180.  
  3181.  
  3182. 2.1. The Purpose of TbScanX
  3183.  
  3184.      TbScanX is the resident version of the TbScan program, checking files on
  3185.      the basis of a virus signature list. Suppose you have a virus scanner
  3186.      automatically executed from your autoexec.bat file. If no viruses are
  3187.      found, your system is supposed to be uninfected. But, to be sure that no
  3188.      virus will infect your system, you have to execute the scanner every
  3189.      time after copying a file to your harddisk, after downloading a file
  3190.      from a bulletin board system, or after unarchiving an archive such as a
  3191.      ZIP file. Be honest, do YOU actually invoke your scanner every time you
  3192.      introduce a new file into the system? If you don't, you take the risk
  3193.      that within a couple of hours all files are infected by a virus... 
  3194.  
  3195.      Once loaded, TbScanX will remain resident in memory, and will automati-
  3196.      cally scan all files you execute and all executable files you copy,
  3197.      create, download, modify, or unarchive. The same approach is used to
  3198.      protect against bootsector viruses: every time you put a diskette into a
  3199.      drive the bootsector will be scanned. If the disk is contaminated with a
  3200.      boot sector virus TbScanX will warn you in time!
  3201.  
  3202.      TbScanX is fully network compatible. It does not require to reload the
  3203.      scanner after logging on to the network. 
  3204.  
  3205.  
  3206. 2.2. How to use TbScanX
  3207.  
  3208.      Since TbScanX is memory resident, the program can be executed and
  3209.      configured from the command line or from within a batch file. It is
  3210.      important to load TbScanX as early as possible after the machine has
  3211.      booted. Therefore it is recommended to execute TbScanX from within the
  3212.      Config.Sys file.
  3213.  
  3214. =>   Note that TbScanX requires TbDriver to be loaded first!
  3215.  
  3216.  
  3217.      Loading TBScanX
  3218.  
  3219.      There are three possible ways to load TbScanX:
  3220.  
  3221.      1. From the DOS prompt or within the Autoexec.Bat file:
  3222.           <path>TbScanX
  3223.  
  3224.      2. From the Config.Sys as a TSR (Dos 4+):
  3225.           Install=<path>TbScanX.Exe 
  3226.  
  3227.      The "Install=" Config.Sys command is NOT available in DOS 3.xx.
  3228.  
  3229.      3. From the Config.Sys as a device driver:
  3230.           Device=<path>TbScanX.Exe
  3231.  
  3232.                                      III - 18
  3233. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3234.  
  3235.  
  3236. =>   Note that executing TbScanX as a device driver does not work in all OEM
  3237.      versions of DOS. If it does not work use the "Install=" command or load
  3238.      TbScanX from within the Autoexec.Bat. TbScanX should always work cor-
  3239.      rectly after being started from within the Autoexec.Bat.
  3240.  
  3241.      Unlike other anti-virus products, the ThunderBYTE anti-virus utlities
  3242.      can be loaded before the network is started without loosing the protec-
  3243.      tion afterwards.
  3244.  
  3245.  
  3246.      Highload TBScanX
  3247.  
  3248.      In addition to the three invocation possibilities users of DOS 5 and
  3249.      higher versions can "highload" TbScanX in UMB (upper memory block) if it
  3250.      is available:
  3251.  
  3252.           LoadHigh <path>TbScanX.Exe
  3253.  
  3254.      Within the Config.Sys file TbScanX can also be loaded high:
  3255.  
  3256.           DeviceHigh=<path>TbScanX.Exe
  3257.  
  3258.  
  3259.      TbScanX and MS-Windows
  3260.  
  3261.      Windows users should load TbScanX BEFORE starting MS-Windows. If you do
  3262.      that there is only one copy of TbScanX in memory, but every DOS-window
  3263.      will nevertheless have a fully functional TbScanX in it. TbScanX detects
  3264.      if Windows is starting up, and will switch itself in multitasking mode
  3265.      if necessary. You can even disable TbScanX in one window without affec-
  3266.      ting the functionality in another window.
  3267.  
  3268.  
  3269. 2.3. Command line options
  3270.  
  3271.      TbScanx can be configured from the command line. The upper four options
  3272.      are always available, the other options are only available if TbScanX is
  3273.      not already resident in memory.
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.                                      III - 19
  3290. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3291.  
  3292.  
  3293.      option  short  explanation
  3294.      --------------------------------------------------
  3295.  
  3296.      help      ?    display this helpscreen
  3297.      off       d    disable scanning
  3298.      on        e    enable scanning
  3299.      remove    r    remove TbScanX from memory
  3300.  
  3301.      noexec    n    never scan at execute
  3302.      allexec   a    always scan at execute
  3303.      noboot    b    do not scan bootsectors
  3304.      ems       me   use expanded memory (EMS)
  3305.      xms       mx   use extended memory (XMS)
  3306.      secure    s    deny access without asking
  3307.      lock      l    lock PC when virus detected
  3308.      compat    c    increased compatibility
  3309.  
  3310.  
  3311.      help (?)
  3312.      If you specify this option TbScanX will show you the commandline options
  3313.      as shown above. Once TbScanX has been loaded the help option will not
  3314.      show all options anymore.
  3315.  
  3316.      off (d)
  3317.      If you specify this option TbScanX will be disabled, but it will remain
  3318.      in memory.
  3319.  
  3320.      on (e)
  3321.      If you use this option TbScanX will be activated again after you dis-
  3322.      abled it with the 'off' option.
  3323.  
  3324.      remove (r)
  3325.      This option can be used to remove the resident part of TbScanX from your
  3326.      memory. All memory used by TbScanX will be released. Unfortunately,
  3327.      removing a TSR (like TbScanX) is not always possible. TbScanX checks
  3328.      whether it is safe to remove the resident part from memory, if it is not
  3329.      safe it just disables TbScanX. A TSR can not be removed if another TSR
  3330.      is started after it. If this happens with TbScanX it will completely
  3331.      disable itself. 
  3332.  
  3333.      compat (c)
  3334.      In most systems TbScanX performs troublefree. Another TSR program may
  3335.      however conflict with TbScanX. If the other TSR is loaded first, TbScanX
  3336.      will normally detect the conflict and use an alternate interrupt. If the
  3337.      other TSR is loaded after TbScanX, and it does abort with a message
  3338.      telling you that it has already been loaded, you can use the 'compat'
  3339.      switch of TbScanX (when installing it in memory). It is also possible
  3340.      that TbScanX conflicts with other EMS or XMS using resident software. In
  3341.      this case the system will hang. Option 'compat' will solve this problem,
  3342.      but due to extensive memory swapping the performance of TbScanX will
  3343.      slow down.
  3344.  
  3345.  
  3346.                                      III - 20
  3347. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3348.  
  3349.  
  3350.      noexec (n)
  3351.      TbScanX normally scans files located on removable media just before they
  3352.      are executed. You can use this option to disable this feature complete-
  3353.      ly.
  3354.  
  3355.      allexec (a)
  3356.      TbScanX normally scans files to be executed only if they reside on
  3357.      removable media. Files on the harddisk are trusted, because these files
  3358.      must have been copied or downloaded before. And by that time TbScanX has
  3359.      already scanned them automatically. However if you want every file to be
  3360.      scanned before executing, no matter whether on harddisk or removable
  3361.      media, you should use this option.
  3362.  
  3363.      noboot (b)
  3364.      TbScanX monitors the disk system: every time the bootsector is being
  3365.      read, TbScanX automatically scans the disk for bootsector viruses. If
  3366.      you change a disk, the first thing DOS has to do is read the bootsector,
  3367.      otherwise it  does not know what kind of disk is in the drive. And as
  3368.      soon as DOS reads the bootsector, TbScanX checks it for viruses. If you
  3369.      don't like this feature, or if it causes problems, you can switch it off
  3370.      using the 'noboot' option. If you specify this option TbScanX will also
  3371.      require less memory, because the bootsector signatures will not be
  3372.      stored in memory.
  3373.  
  3374.      secure (s)
  3375.      TbScanX normally asks the user to continue or to cancel when it detects
  3376.      a virus. In some business environments however this choice should not be
  3377.      made by employees. By using option 'secure' it is no longer possible to
  3378.      allow suspicious operations.
  3379.  
  3380.      lock (l) 
  3381.      System operators can use this option to instruct TbScanX to lock the
  3382.      system once a virus is detected.
  3383.  
  3384.      ems (me)
  3385.      If you specify this option TbScanX will use expanded memory (like
  3386.      provided by LIM/EMS expansion boards or 80386 memory managers) to store
  3387.      the signatures and part of its program code. Since conventional memory
  3388.      is more valuable to your programs than expanded memory, the use of EMS
  3389.      memory is recommended. TbScanX can use up to 64Kb of EMS memory. Expan-
  3390.      ded memory is allocated in 16Kb blocks.
  3391.  
  3392.      xms (mx)
  3393.      If you specify this option TbScanX will use extended memory to store the
  3394.      signatures and part of its program code. An XMS driver (like HIMEM.SYS)
  3395.      needs to be installed to be able to use this option. XMS memory is not
  3396.      directly accessable from within DOS, so every time TbScanX has to scan
  3397.      data it has to copy the signatures to conventional memory. 
  3398.  
  3399.      To be able to save the original memory contents TbScanX needs a double
  3400.      amount of XMS memory. Swapping to XMS is slower than swapping to EMS
  3401.      memory, so if you have EMS memory available swapping to EMS is recommen-
  3402.  
  3403.                                      III - 21
  3404. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3405.  
  3406.  
  3407.      ded. It is possible that swapping to XMS conflicts with some other
  3408.      software, so if you experience problems try using TbScanX without the
  3409.      XMS option. 
  3410.  
  3411.      Example
  3412.           Device=C:\utils\TbScanX.Exe xms noboot
  3413.  
  3414.  
  3415. 2.4. While scanning
  3416.  
  3417.      Whenever a program tries to write to an executable file (files with the
  3418.      extensions .COM and .EXE), you will briefly see the text "*Scanning*" in
  3419.      the upper left corner of your screen.  As long as TbScanX is scanning
  3420.      this text will appear. Since TbScanX takes very little time to scan the
  3421.      file, the message will only appear very briefly. The text "*Scanning*"
  3422.      will also appear if you execute a program directly from a diskette, and
  3423.      if DOS accesses the bootsector of a diskette drive.
  3424.  
  3425.  
  3426.      Detecting Viruses
  3427.  
  3428.      If TbScanX detects a suspicious signature that is about to be   written
  3429.      into a file, a window will appear with the message:
  3430.  
  3431.           WARNING, <filename> contains <virus name>!
  3432.           Abort? (Y/n)
  3433.  
  3434.      Press "N" to continue, press any other key to abort.
  3435.  
  3436.      If TbScanX detects a suspicious signature in a boot sector, it will
  3437.      display the message:
  3438.  
  3439.           WARNING, Disk in <drive> contains <virus name>!
  3440.           Press a key...
  3441.  
  3442.      Although a virus seems to be on the bootsector of the specified drive,
  3443.      the virus cannot do anything since it has not been executed yet. Howe-
  3444.      ver, if you reboot the machine with the contaminated diskette in the
  3445.      drive, the virus will copy itself to your harddisk.
  3446.  
  3447.      To display the name of the virus, TbScanX needs the signature file
  3448.      again. It will automatically use the signature file that was used when
  3449.      you invoked the program. If the signature file is missing (because you
  3450.      deleted it, or because you removed the  floppy containing it), or no
  3451.      file handles are left, TbScanX will still detect viruses, but it is no
  3452.      longer able to display the name of the virus. It will display [Name
  3453.      unknown] instead.
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.                                      III - 22
  3461. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3462.  
  3463.  
  3464. 3.  TbCheck
  3465.  
  3466.  
  3467. 3.1. The Purpose of TbCheck
  3468.  
  3469.      TbCheck is a memory-resident integrity checker, coming into action
  3470.      whenever a file is about to be executed. It uses the Anti-Vir.Dat
  3471.      records generated by TbSetup to detect file changes, often the first
  3472.      sign of a virus infection. These records contain information, such as
  3473.      file sizes and checksums, of every executable file in a directory. By
  3474.      comparing this information with the actual file status it is possible to
  3475.      detect any changes, including infections caused by viruses - automati-
  3476.      cally.
  3477.  
  3478.      Suppose you have a conventional integrity checker automatically invoked
  3479.      in your autoexec.bat file. If no files are changed, your system is
  3480.      supposed to be uninfected. But, to be sure that no virus can infect your
  3481.      system, you have to execute the checker frequently.
  3482.  
  3483.      Once loaded TbCheck will remain resident in memory, and will automa-
  3484.      tically check all programs you try to execute.
  3485.  
  3486.      TbCheck is fully network compatible. It does not require you to reload
  3487.      the checker after logged on to the network.
  3488.  
  3489.  
  3490. 3.2. How to use TbCheck
  3491.  
  3492.      Since TbCheck is a memory resident program, it can be executed and
  3493.      configured from the command line or from within a batch file. TbCheck
  3494.      should however be started automatically and as soon as the computer
  3495.      boots up, preferably during the execution of Config.Sys or Autoexec.Bat
  3496.      file. 
  3497.  
  3498. =>   Be sure TbDriver has already been loaded - TbCheck wil refuse to start
  3499.      up without it.
  3500.  
  3501.  
  3502.      Loading TbCheck
  3503.  
  3504.      There are three possible ways to start TbCheck:
  3505.        
  3506.      1. From the DOS prompt or within the Autoexec.Bat file:
  3507.           <path>TbCheck
  3508.  
  3509.      2. From the Config.Sys as a TSR (Dos 4+):
  3510.           Install=<path>TbCheck.Exe
  3511.  
  3512.      The "Install=" Config.Sys command is NOT available in DOS 3.xx.
  3513.  
  3514.      3. To invoke TbCheck from the Config.Sys as a device driver:
  3515.           Device=<path>TbCheck.Exe
  3516.  
  3517.                                      III - 23
  3518. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3519.  
  3520.  
  3521.      Executing TbCheck as a device driver does not work in all OEM versions
  3522.      of DOS. If it doesn't work use the "Install=" command or load TbCheck
  3523.      from within the Autoexec.Bat.
  3524.  
  3525.      TbCheck should always work correctly after being started from within the
  3526.      Autoexec.Bat. Unlike other anti-virus products, the Thunderbyte anti-
  3527.      virus utilities can be loaded before the network is started without
  3528.      losing the protection after the network is started.
  3529.  
  3530.  
  3531.      Highload  TbCheck
  3532.  
  3533.      In addition to the three invocation possibilities DOS 5 users can
  3534.      "highload" TbCheck in a UMB (upper memory block) if it is available:
  3535.  
  3536.           LoadHigh <path>TbCheck.Exe
  3537.  
  3538.      Within the Config.Sys file TbCheck can also be loaded high:
  3539.  
  3540.           DeviceHigh=<path>TbCheck.Exe
  3541.  
  3542.  
  3543.      TbCheck and MS-Windows
  3544.  
  3545.      Windows users should load TbCheck BEFORE starting Windows. If you do
  3546.      that, there is only one copy of TbCheck in memory, but every DOS-window
  3547.      will nevertheless have a fully functional TbCheck in it.  TbCheck
  3548.      detects if Windows is starting up, and will switch itself into multitas-
  3549.      king mode if necessary. You can even disable TbCheck in one window
  3550.      without affecting the functionality in another window.
  3551.  
  3552.  
  3553. 3.3. Command line options
  3554.  
  3555.      It is possible to specify options on the command line. The upper four
  3556.      options are always available, the other options are available only if
  3557.      TbCheck is not memory resident.
  3558.  
  3559.  
  3560.      option  parameter shortexplanation
  3561.      ------  --------- -----------------------
  3562.  
  3563.      help              ?    display this helpscreen
  3564.      off               d    disable checking
  3565.      on                e    enable checking
  3566.      remove            r    remove TbCheck from memory
  3567.  
  3568.      noavok  [=<drives>]o   check for mismatches only
  3569.      fullcrc           f    calculate full CRC (slow!)
  3570.      secure            s    do not execute unauthorized files
  3571.  
  3572.  
  3573.  
  3574.                                      III - 24
  3575. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3576.  
  3577.  
  3578.      help (?)
  3579.      If you specify this option TbCheck displays the above options list.
  3580.  
  3581.      off (d)
  3582.      Disables TbCheck, but it will remain in memory and can be reactivated.
  3583.  
  3584.      on (e)
  3585.      TbCheck will be reactivated after having been disabled with the 'off'
  3586.      option.
  3587.  
  3588.      remove (r)
  3589.      This option disables TbCheck and will try to remove the resident part
  3590.      from memory. Unfortunately, this can only work if TbCheck was loaded
  3591.      last. An attempt to remove a TSR after another TSR has been started will
  3592.      simply leave a useless gap in memory and could disrupt the interrupt
  3593.      chain. TbCheck will try to find out whether it is safe to remove its
  3594.      resident code; if not, it will simply disable itself. 
  3595.  
  3596.      noavok (o)
  3597.      TbCheck will look for checksum information on the file you want to be
  3598.      checked in the Anti-Vir.Dat file. TbCheck will display a message if no
  3599.      checksum information is found or if the specific checksum is incorrect.
  3600.      This makes sure that you will receive a warning whenever a malicious
  3601.      program deletes the Anti-Vir.Dat file. 
  3602.  
  3603.      Although it is recommended to maintain Anti-Vir.Dat files on all drives,
  3604.      this may not always be practical with floppy disks, RAM disks or CD-ROM
  3605.      disks. Option 'noavok' tells TbCheck not to look for an Anti-Vir.Dat on
  3606.      specific drives. For instance, if you don't want to be alerted about the
  3607.      absence of an Anti-Vir.Dat record on floppy disks (A: and B:) or on your
  3608.      RAM disk (E:) you should specify:
  3609.  
  3610.           "NoAvOk=ABE"
  3611.  
  3612.      If you don't specify a drive to the 'noavok' option, TbCheck will never
  3613.      issue a warning if an Anti-Vir record is missing on any drive. 
  3614.  
  3615. =>   Note that this presents a security hole for viruses: by deleting the
  3616.      Anti-Vir.Dat file you will not be able to detect file changes caused by
  3617.      a viral infection.
  3618.  
  3619. =>   Please note that the 'noavok' option does not do anything to prevent the
  3620.      detection of infected programs if the Anti-Vir record is available. If a
  3621.      program has been changed and the Anti-Vir record is available, you will
  3622.      still get an alarm regardless of how option 'noavok' was implemented.
  3623.  
  3624.      fullcrc (f)
  3625.      By default, TbCheck only verifies that part of the file near the pro-
  3626.      gram's entry point. If a virus infects the file, this area is guaranteed
  3627.      to change, so this is perfectly adequate to detect all infections. Other
  3628.      file changes, notably configuration variations, will not trigger the
  3629.      alarm. If, however, you should ever desire a full check that detects any
  3630.  
  3631.                                      III - 25
  3632. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3633.  
  3634.  
  3635.      file changes, this option will take care of it. Note that this slows
  3636.      down the system considerably - this option is not recommended for normal
  3637.      (anti-virus) usage! 
  3638.  
  3639.      secure (s)
  3640.      TbCheck normally asks whether the user wants to continue or cancel when
  3641.      a file has been changed or when there is no checksum information availa-
  3642.      ble. In a business environment it may be unwise to leave such decisions
  3643.      to employees. Option 'secure' makes it impossible to execute new or
  3644.      unknown programs, or programs that have been changed.
  3645.  
  3646.  
  3647. 3.4. While checking
  3648.  
  3649.      Whenever a program wants to execute, TbCheck steps in to see if it
  3650.      really has the authority to do so. During that time it will display
  3651.      '*Checking*' in the screen's upper left hand corner. TbCheck operates at
  3652.      lightning speed, therefore the message will appear only momentarily. 
  3653.  
  3654.      Since TbCheck does not take much time to check the file, you will see
  3655.      the message only in a short notice of time.
  3656.  
  3657.  
  3658.      Detecting File Changes
  3659.  
  3660.      TbCheck quickly checks a program when that program is loaded. If TbCheck
  3661.      detects that a file has been changed, a pop-up window will appear to
  3662.      inform you. You can either choose to continue, or to abort the program
  3663.      invocation.
  3664.  
  3665.      If there is no information (Anti-Vir.Dat) about the program, TbCheck
  3666.      will inform you about this too. You can either choose to continue
  3667.      without checking, or to abort the program invocation. 
  3668.  
  3669. =>   Note that you can prevent users from executing non authorized software
  3670.      by combining the TbCheck command with the 'secure' option.
  3671.  
  3672.  
  3673. 3.5. Testing TbCheck
  3674.  
  3675.      Many people understandably wish to test the product they are using. In
  3676.      contrast with, for instance, a word processor, it is very difficult to
  3677.      test a smart integrity checker like TbCheck. You cannot change a random
  3678.      25 bytes of an executable file just to find out whether or not TbCheck
  3679.      will detect the file change. On the contrary, it is very likely that
  3680.      TbCheck will NOT detect it because the program only checks the entry-
  3681.      area of the file whereas the changed bytes might be located on another
  3682.      location within the file.
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.                                      III - 26
  3689. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3690.  
  3691.  
  3692. 4. TbClean
  3693.  
  3694.  
  3695. 4.1. The Purpose of TbClean
  3696.  
  3697.      TbClean isolates viral code in an infected program and removes it. From
  3698.      then on it will be safe to use the program again, as the risk of other
  3699.      files being infected or damaged by it will have been securely elimina-
  3700.      ted.
  3701.  
  3702.  
  3703.      Generic Cleaners
  3704.  
  3705.      TbClean works completely different compared to 'conventional cleaners.
  3706.      First of all, it does not recognize any virus. Its disinfection scheme
  3707.      is completely different and it works with almost any virus. Actually,
  3708.      the TbClean program contains two cleaners: a 'repair' cleaner, and a
  3709.      'heuristic' cleaner. The repair cleaner needs an Anti-Vir.Dat file that
  3710.      is generated by the TbSetup program before the infection occurs. In this
  3711.      Anti-Vir.Dat file essential information is stored, like the original
  3712.      file size, the bytes at the beginning of the program, a cryptographic
  3713.      checksum to verify the results, etc. This information enables TbClean to
  3714.      disinfect almost every file, regardless of the virus it has been infec-
  3715.      ted with, known or unknown. 
  3716.  
  3717.  
  3718.      No information available?
  3719.  
  3720.      In the heuristic cleaning mode TbClean does not need any information
  3721.      about viruses either, but it has the added advantage that it does not
  3722.      even care about the original, uninfected state of a program. This
  3723.      cleaning mode is very effective if your system is infected with an
  3724.      unknown virus and yo neglected to let TbSetup generate the Anti-Vir.Dat
  3725.      files in time.
  3726.  
  3727.      In the heuristic mode, TbClean loads the infected file and starts
  3728.      emulating the program code to find out which part of the file belongs to
  3729.      the original program and which to the virus. The result is successful if
  3730.      the functionality of the original program is restored, and the functio-
  3731.      nality of the virus has been reduced to zero. 
  3732.  
  3733. =>   Note that this does not imply that the cleaned file is 100% equal to the
  3734.      original.
  3735.  
  3736.      When TbClean uses heuristic cleaning to disinfect the program, the file
  3737.      will most likely not be exactly the same as in its original state. This
  3738.      is not an indication of failure of TbClean, nor does it mean the file is
  3739.      still infected in some way. First of all, it is normal that the heuris-
  3740.      tically cleaned file is still larger than the original. This is normal
  3741.      because TbClean tries to be on the safe side and it will avoid removing
  3742.      too much. The bytes left at the end of the file are 'dead' code, the
  3743.      instructions will never be executed again since the 'jump' at the
  3744.  
  3745.                                      III - 27
  3746. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3747.  
  3748.  
  3749.      beginning of the program has been removed. If the cleaned file is an EXE
  3750.      type file, it is likely that some bytes in front of the program - the
  3751.      exeheader - are different. 
  3752.      There are many suitable solutions to reconstruct the exeheader, and
  3753.      TbClean can of course never know the original state of the program. The
  3754.      functionality of the cleaned file will nevertheless be the same! 
  3755.  
  3756. =>   Note that this only applies to heuristic cleaning: if there is a suit-
  3757.      able Anti-Vir.Dat record available, the cleaned program will normally be
  3758.      exactly the same as the original clean file.
  3759.  
  3760.      It is possible that the infected file is infected with multiple viruses,
  3761.      or multiple instances of the same virus! Some viruses keep on infecting
  3762.      files, and in such case the infected files will keep growing. If TbClean
  3763.      used its heuristic cleaning mode, it is very likely that TbClean removed
  3764.      only one instance of the virus. In this case, it is necessary to repeat
  3765.      the cleaning process until TbClean reports that it can not remove
  3766.      anything anymore.
  3767.  
  3768.  
  3769. 4.2. How to use TbClean
  3770.  
  3771.      After tracking one or more viruses, all you should do is select the
  3772.      'Start cleaning' option in the TbClean menu. After specifying the
  3773.      relevant filename, TbClean will come into action. Beforehand, TbClean
  3774.      allows some additional parameters. These parameters are discussed below.
  3775.  
  3776.  
  3777.      The TbClean menu
  3778.  
  3779.      You can execute TbClean in combination with some useful parameters,
  3780.      which are listed in the TbClean menu. You can activate these parameters
  3781.      by toggling the selection bar to the desired option and type <ENTER>. A
  3782.      checkmark indicates that the specific parameter is ON.
  3783.  
  3784.  
  3785.      +----Main menu-----+
  3786.      |  Confi+-----TbClean menu-----+
  3787.      |  TbSet|  Start cleaning      |
  3788.      |  TbSca|  List-file name      |
  3789.      |  TbUti|  Use TBAV.INI file   |
  3790.      |  TbCLe|  Prompt for pause    |
  3791.      |  TBAV |v Use Anti-Vir.Dat    |
  3792.      |  Docum|v Expanded memory     |
  3793.      |  Quit |  Show program loops  |
  3794.      |  eXit |  Make list file      |
  3795.      +-------+----------------------+
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.                                      III - 28
  3803. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3804.  
  3805.  
  3806.      List-file name 
  3807.  
  3808.      By selecting this option you may specify a filename to be used as list-
  3809.      file (see also option 'make list-file'). 
  3810.  
  3811.  
  3812.      Use TBAV.INI file
  3813.  
  3814.      By enabling this option, the TbClean configuration values, saved in the
  3815.      TBAV.INI file, will also be valid when loading TbClean from the command
  3816.      line. Be careful, since options specified in the TBAV.INI file can not
  3817.      be undone on the command line. See chapter I-2 ('Configuration').
  3818.  
  3819.  
  3820.      Prompt for pause 
  3821.  
  3822.      TbClean will stop disassembling information after each full screen to
  3823.      let you examine the results.
  3824.  
  3825.  
  3826.      Use Anti-Vir.Dat 
  3827.  
  3828.      If this option is deselected, TbClean will act as if there were no Anti-
  3829.      Vir.Dat records available and will therefore perform heuristic cleaning.
  3830.  
  3831.  
  3832.      Show program loops
  3833.  
  3834.      By default TbClean keeps track of looping conditions to keep an iterati-
  3835.      on that would be emulated thousands of times from being listed on your
  3836.      screen. With this option TbClean 'works out' every loop. 
  3837.  
  3838. =>   Note that TbClean will perform at a drastically reduced speed. Do not
  3839.      combine this option with the 'list' option, because the list file might
  3840.      grow too big.
  3841.  
  3842.  
  3843.      Expanded memory
  3844.  
  3845.      If activated, TbClean will detect the presence of expanded memory and
  3846.      will use it in heuristic mode. You may disable EMS usage if it is too
  3847.      slow, or if your expanded memory manager is not very stable.
  3848.  
  3849.  
  3850.      Make list file 
  3851.  
  3852.      TbClean will generate an output file with a chronological disassembly of
  3853.      the virus being removed. 
  3854.  
  3855.  
  3856.  
  3857.  
  3858.  
  3859.                                      III - 29
  3860. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3861.  
  3862.  
  3863. 4.3. Command line options
  3864.  
  3865.      TbClean recognizes option short-keys and option words. The words are
  3866.      easier to memorize, and they will be used in this manual for convenien-
  3867.      ce.
  3868.  
  3869.  
  3870.      option     parameter         shortexplanation
  3871.      ---------------------------------------------------------------
  3872.      help                         he   help (-? = short help)
  3873.      pause                        pa   enable 'Pause' prompt
  3874.      mono                         mo   force monochrome
  3875.      noav                         na   do not use Anti-Vir.Dat record
  3876.      noems                        ne   do not use expanded memory
  3877.      showloop                     sl   show every loop iteration
  3878.      list       [=<filename>]     li   create list file
  3879.  
  3880.  
  3881.      Below, all command line options are explained briefly.
  3882.  
  3883.      help (he)
  3884.      If you specify this option TbClean displays the contents of the TBCLE-
  3885.      AN.HLP file if it is available in the home directory of TbClean.  If you
  3886.      specify the '?' option you will get the summarized help info as listed
  3887.      above.
  3888.  
  3889.      pause (pa)
  3890.      TbClean will stop disassembling information after each full screen to
  3891.      let you examine the results.
  3892.  
  3893.      mono (mo)
  3894.      This option forces TbClean to refrain from using colors in the screen
  3895.      output. This might enhance the screen output on some LCD screens or
  3896.      color-emulating monochrome systems.
  3897.  
  3898.      noav (na)
  3899.      If this option is specified, TbClean will act as if there were no Anti-
  3900.      Vir.Dat records available and will therefore perform heuristic cleaning.
  3901.  
  3902.      noems (ne)
  3903.      If specified, TbClean will not detect the presence of expanded memory
  3904.      and will use it in heuristic mode. You may disable EMS usage if it is
  3905.      too slow, or if your expanded memory
  3906.      manager is not very stable.
  3907.  
  3908.      showloop (sl)
  3909.      By default TbClean keeps track of looping conditions to keep an iterati-
  3910.      on that would be emulated thousands of times from being listed on your
  3911.      screen. With this option TbClean 'works out' every loop. 
  3912.  
  3913.  
  3914.  
  3915.  
  3916.                                      III - 30
  3917. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3918.  
  3919.  
  3920. =>   Note that TbClean will perform at a drastically reduced speed. Do not
  3921.      combine this option with the 'list' option, because the list file might
  3922.      grow too big.
  3923.  
  3924.      list [=<filename>] (li)
  3925.      TbClean will generate an output file with a chronological disassembly of
  3926.      the virus being removed. 
  3927.  
  3928.      Examples
  3929.           TbClean VIRUS.EXE
  3930.  
  3931.      TbClean will make a backup with the name VIRUS.VIR and it will disinfect
  3932.      VIRUS.EXE
  3933.  
  3934.           TbClean VIRUS.EXE TEST.EXE
  3935.  
  3936.      TbClean will copy VIRUS.EXE to TEST.EXE and disinfect
  3937.      TEST.EXE
  3938.  
  3939.  
  3940. 4.4. The cleaning process
  3941.  
  3942.      Choose 'Start cleaning' in the TBAV menu. Now you specify the name of
  3943.      the file that has to be cleaned. Suppose you want an infected program
  3944.      file named 'virus.exe' to be cleaned:
  3945.  
  3946.      Enter name of program to clean. TbClean will create a backup first!
  3947.                C:\VIRUS\VIRUS.EXE 
  3948.  
  3949.      The ThunderBYTE utility cleans on a file-by-file approach: clean one
  3950.      file, verify the result, and proceed with the next file. This helps you
  3951.      to keep track of which file is clean, which file is damaged and should
  3952.      be restored from a backup, and which
  3953.      file is still infected.
  3954.  
  3955.      Enter name of cleaned file. Keep blank if infected program may be
  3956.      changed.
  3957.                C:\VIRUS\TEST.EXE
  3958.  
  3959.      By specifying a different name (eg. 'test.exe') you indicate that the
  3960.      cleaned file may not overwrite the original .exe file. In this example
  3961.      TbClean will copy VIRUS.EXE to TEST.EXE and disinfect TEST.EXE. Next,
  3962.      TbClean will start the cleaning process.  
  3963.  
  3964.      If you do not specify a backup filename, TbClean will create a backup
  3965.      with the '.vir' extension (eg. VIRUS.VIR) and it will disinfect the .exe
  3966.      file.
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.                                      III - 31
  3974. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  3975.  
  3976.  
  3977.      +-----------------------------------------------------------------+
  3978.      |  Thunderbyte clean utility v6.03 (C) 1992-93 Thunderbyte B.V.   |
  3979.      +---------Infected state----------++---------Original state-------+
  3980.      | Entry point (CS:IP)   34BF:0012 || Entry point (CS:IP) 34BF:0012|
  3981.      | File length                     || File length         UNKNOWN! |
  3982.      | Cryptographic CRC     9F90F52A  || Cryptographic CRC   UNKNOWN! |
  3983.      +---------------------------------++------------------------------+
  3984.      |                                                                 |
  3985.      | Starting clean attempt. Analyzing infected file...              |
  3986.      | Anti-Vir not found: original state unknown. Trying emulation... |
  3987.      | Emulation terminated:                                           |
  3988.      |                                                                 |
  3989.      | C:\VIRUS\TEST.EXE                                               |
  3990.      | CS:IP    Instruction     AX  BX  CX  DX  DS  SI  ES  DI  SS  SP |
  3991.      | 9330:0101  mov ah,40    FFFE9330FFFFEFFFD382FFEDEFFEFFFF9520007E|
  3992.      | 9330:0103  mov bx,0002  40FE9330FFFFEFFFD382FFEDEFFEFFFF9520007E|
  3993.      | 9330:0106  mov cx,0016  40FE0002FFFFEFFFD382FFEDEFFEFFFF9520007E|
  3994.      | 9330:0109  mov dx,cs    40FE00020016EFFFD382FFEDEFFEFFFF9520007E|
  3995.      | 9330:010B  mov ds,dx    40FE000200169330D382FFEDEFFEFFFF9520007E|
  3996.      | 9330:010D  mov dx,0117  40FE0002001693309330FFEDEFFEFFFF9520007E|
  3997.      | 9330:0110  int 21       40FE0002001601179330FFEDEFFEFFFF9520007E|
  3998.      | 9330:0112  mov ax,4CFF  40FE0002001601179330FFEDEFFEFFFF9520007E|
  3999.      | 9330:0115  int 21       4CFF0002001601179330FFEDEFFEFFFF9520007E|
  4000.      | 9330:0115  <End of emulation>                                   |
  4001.      +-----------------------------------------------------------------+ 
  4002.  
  4003.      While Cleaning
  4004.  
  4005.      TbClean will display as much information as possible about the current
  4006.      operation, as illustrated above. All the major actions will be in the
  4007.      emulation window, displaying a disassembly and the register contents of
  4008.      the program under scrutiny, along with a progress report. The status
  4009.      windows reveal useful details of the infected file and, if TbClean can
  4010.      find a suitable Anti-Vir.Dat file, its original status. You may abort
  4011.      the cleaning process by pressing <Ctrl-Break>.
  4012.  
  4013.  
  4014.      The job isn't done yet    
  4015.  
  4016.      A successful purge is not the end of the story! Your job is only parti-
  4017.      ally completed. Some viruses damage data files. They could randomly
  4018.      change bytes on your disks, swap sectors, or perform other nasty tricks.
  4019.      A cleaning utility will never be able to repair your data! Check your
  4020.      data files thoroughly and consult a viral expert to find out what the
  4021.      virus is capable of doing. If there is any doubt, restoring the data is
  4022.      definitely the most reliable option.
  4023.  
  4024. =>   Under no circumstances should you continue to use cleaned software!
  4025.  
  4026.      Cleaning is a temporary solution to allow you to delay a large restore
  4027.      operation until the first available slack period. You should not rely on
  4028.      a cleaned program for any length of time.  Please, don't take this as a
  4029.  
  4030.                                      III - 32
  4031. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4032.  
  4033.  
  4034.      put down of antiviral cleaning agents. If your data is valuable to you,
  4035.      you should care for it as much as possible, and sticking to original
  4036.      software only is no more than an elementary precaution. In other words,
  4037.      restore the original programs as soon as possible!
  4038.  
  4039.  
  4040.      Cleaning Limitations
  4041.  
  4042.      Although TbClean has a very high success rate and is able to clean
  4043.      programs that other cleaners refuse to process, not all viruses can be
  4044.      removed, and not all files can be cleaned. 
  4045.  
  4046.      Viruses that cannot be removed from an infected file:
  4047.  
  4048.      Overwriting viruses. 
  4049.  
  4050.      This type of virus does not add itself to the end of the original
  4051.      program, they just copy themselves over the original file. They do not
  4052.      attempt to start the original program but they will simply return you to
  4053.      DOS after they are activated or will hang the machine. Since the origi-
  4054.      nal file is overwritten and damaged, no cleaner can remove the virus. 
  4055.  
  4056.      Some encrypted viruses. 
  4057.  
  4058.      TbClean is usually able to decrypt the virus. However, some viruses use
  4059.      anti-debugger features that TbClean cannot cope with yet. 
  4060.  
  4061.  
  4062.      The way some program files are constructed makes them impossible to
  4063.      clean and reinstatement will be the only option. This category includes:
  4064.  
  4065.      EXE-programs with internal overlays. 
  4066.  
  4067.      TbScan marks these files with an 'i' flag. Any infection is bound to
  4068.      cause major damage to these files. Some viruses recognize such programs
  4069.      and do not infect them, but most viruses infect these programs anyway,
  4070.      and corrupt the program. No cleaner can repair such damage.
  4071.  
  4072.      Programs with sanity check routines. 
  4073.  
  4074.      Some programs - mostly anti-virus software or copy-protected programs -
  4075.      perform some kind of sanity check. Heuristic cleaning of an infected
  4076.      program normally results in a program that is not physically identical
  4077.      to the original. Although the virus is removed from the program and the
  4078.      program is functionally identical to the original, the sanity check will
  4079.      usually detect the slight changes and abort the program.
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.                                      III - 33
  4088. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4089.  
  4090.  
  4091.      Multiple files cleaning
  4092.  
  4093.      TbClean has no provisions for cleaning multiple programs in one run.
  4094.      There are two reasons for this omission:
  4095.  
  4096.      -    TbClean can not search for viruses automatically since it does not
  4097.           know any virus.
  4098.  
  4099.      -    We highly recommend to clean the system on a file-by-file approach.
  4100.           Clean one file, verify the result, and proceed with the next file.
  4101.           This helps you to keep track of which file is clean, which file is
  4102.           damaged and should be restored from a backup, and which file is
  4103.           still infected.
  4104.  
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.                                      III - 34
  4145. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4146.  
  4147.  
  4148. 5. Ongoing virus prevention: TbMon
  4149.  
  4150.      The Purpose of TbMon utilities
  4151.  
  4152.      TbMon is a set of three memory resident anti-virus utilities:
  4153.  
  4154.      TbMem     Detects attempts of programs to remain resident in                                                                  memory, and
  4155.                makes sure that no program can remain resident in memory
  4156.                without permission.
  4157.  
  4158.      TbFile    detects attempts of programs to infect other programs. 
  4159.  
  4160.      TbDisk    detects attempts of programs to write directly to the disk
  4161.                (without using DOS), attempts to format, etc.
  4162.  
  4163.      Instructions on how to use these utilities are presented below. 
  4164.  
  4165.  
  4166.      How to use TbMon programs
  4167.  
  4168.      Loading TBMon programs
  4169.      The TbMon programs are all loaded in the same way. For specific informa-
  4170.      tion on each of the programs, such as commandline options, please refer
  4171.      to the appropriate sections in this chapter.
  4172.  
  4173.      There are three possible ways to start the TbMon programs:
  4174.  
  4175.      From the DOS prompt or within the Autoexec.Bat file:
  4176.           <path>Tbxx
  4177.  
  4178.      From the Config.Sys as a TSR (Dos 4+):
  4179.           Install=<path>Tbxxx.Exe
  4180.  
  4181.      The "Install=" Config.Sys command is NOT available in DOS 3.xx.
  4182.  
  4183.      To invoke a TbMon program from the Config.Sys as a device driver:
  4184.           Device=<path>Tbxxx.Exe
  4185.  
  4186.  
  4187.      Executing a TbMon program as a device driver does not work in all OEM
  4188.      versions of DOS. If it doesn't work use the "Install=" command or load
  4189.      the program from within the Autoexec.Bat.
  4190.  
  4191.      A TbMon program should always work correctly after being started from
  4192.      within the Autoexec.Bat. Unlike other anti-virus products, the Thunder-
  4193.      byte anti-virus utilities can be loaded before the network is started
  4194.      without losing the protection after the network is started.
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.                                      III - 35
  4202. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4203.  
  4204.  
  4205.      Highload TBMon programs
  4206.  
  4207.      In addition to the three invocation possibilities DOS 5 users can
  4208.      "highload" TbMon programs in a UMB (upper memory block) if it is availa-
  4209.      ble:
  4210.  
  4211.           LoadHigh <path>Tbxxx.Exe
  4212.  
  4213.  
  4214.      Within the Config.Sys file a TbMon program can also be loaded high:
  4215.  
  4216.           DeviceHigh=<path>Tbxxx.Exe
  4217.  
  4218.  
  4219.      TBMon and MS-Windows
  4220.  
  4221.      Windows users should load a TbMon program BEFORE starting Windows. If
  4222.      you do that there is only one copy of the TbMon program in memory, but
  4223.      every DOS-window will nevertheless have the fully functional TbMon
  4224.      program in it. The TbMon program detects if Windows is starting up, and
  4225.      will switch itself into multitasking mode if necessary. You can even
  4226.      disable the program in one window without affecting the functionality in
  4227.      another window.
  4228.  
  4229.  
  4230.      Command line options
  4231.  
  4232.      All TbMon utilities can be loaded in combination with several options.
  4233.      You may specify the options listed below in combination with all three
  4234.      utilities. The specific options are described in the relevant sections.
  4235.  
  4236.      help (?)
  4237.      If you specify this option the TbMon program will show you the brief
  4238.      help as shown above.
  4239.  
  4240.      off (d)
  4241.      If you specify this option the TbMon program will be disabled, but it
  4242.      will remain in memory.
  4243.  
  4244.      on (e)
  4245.      If you use this option the TbMon program will be activated again after
  4246.      you disabled it with the 'off' option.
  4247.  
  4248.      remove (r)
  4249.      This option can be used to remove the resident part of the TbMon program
  4250.      from your system's memory. All memory used by the TbMon program will be
  4251.      released. Unfortunately, the removal of a TSR is not always possible. 
  4252.      The TbMon program checks whether it is safe to remove the resident part
  4253.      from memory. If it is not safe it just disables the TbMon program. A TSR
  4254.      can not be removed if another TSR has been started after it. If this
  4255.      happens with the TbMon program, it will completely disable itself.
  4256.  
  4257.  
  4258.                                      III - 36
  4259. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4260.  
  4261.  
  4262. 5.1. TbMem
  4263.  
  4264.      The Purpose of TbMem
  4265.  
  4266.      Most viruses remain resident in memory once they have been executed.
  4267.      While resident in memory, they may have many opportunities to infect
  4268.      other files in the background, interfere with the system operation, hide
  4269.      themselves from virus scanners or checksummers, and/or perform other
  4270.      nasty tasks.
  4271.  
  4272.      On the other hand, because so many viruses remain resident in memory, it
  4273.      is easy to detect most of them once the process of becoming resident in
  4274.      memory is monitored.
  4275.  
  4276.      TbMem monitors the system and ensures that no program will remain
  4277.      resident in memory without permission. This will draw attention to any
  4278.      software that attempts to remain resident, thereby reducing the likeli-
  4279.      hood that a virus will be able to go unnoticed. TbMem also protects
  4280.      CMOS.
  4281.  
  4282.  
  4283.      What is a memory-resident program?
  4284.  
  4285.      Most programs will be invoked by a command on the DOS command line,
  4286.      perform some task, and finally terminate, placing you right back where
  4287.      you started.
  4288.       
  4289.      Some programs however continue to operate after they are terminated.
  4290.      These programs load themselves into memory of your PC, remain resident
  4291.      in the memory and perform some task in the background. Programs in this
  4292.      category are disk caches, print spoolers, network software, etc. These
  4293.      programs are often referred to as 'TSR-software', which means 'Termina-
  4294.      te-and-Stay-Resident'.
  4295.  
  4296.      Most viruses remain resident in memory too, and that is why the process
  4297.      of becoming resident in memory should be controlled in some way, prefe-
  4298.      rably by TbMem.
  4299.  
  4300.      TbMem offers you the option to abort the program before it can become
  4301.      resident. TbMem will guard the DOS TSR function calls, while also
  4302.      monitoring important interrupts and memory structures. TbMem uses the
  4303.      Anti-Vir.Dat records to determine whether a program is allowed to remain
  4304.      resident in memory.
  4305.  
  4306.      Many common TSRs will be recognized by TbSetup. However, if TbSetup
  4307.      doesn't recognize a TSR, TbMem will ask your permission for the TSR to
  4308.      load. Permission information will be maintained in the Anti-Vir.Dat
  4309.      files, to prevent TbMem from bothering you when an approved TSR is
  4310.      loading.
  4311.  
  4312.      TbMem will also check the contents of the CMOS configuration memory
  4313.      after each program termination, to make sure that programs do not change
  4314.  
  4315.                                      III - 37
  4316. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4317.  
  4318.  
  4319.      it unnoticed. TbMem offers the possibility to restore the CMOS configu-
  4320.      ration when it has been changed. Once you have 'taught' TbMem which
  4321.      programs are TSRs and which are not on one PC, you can use TbSetup to
  4322.      set the permission flag of these files on other machines.
  4323.  
  4324.      TbMem installs a hot key that can be used to escape from nearly all
  4325.      programs.
  4326.  
  4327.      TbMem is fully network compatible. It does not require you to reload the
  4328.      checker after logging on to a network. 
  4329.  
  4330.  
  4331.      How to use TbMem
  4332.  
  4333.      Since TbMem is a memory resident program, it can be executed and confi-
  4334.      gured from the command line or from within a batch file. TbMem should
  4335.      however be started automatically and as soon as the computer boots up,
  4336.      preferably during the execution of Config.Sys or Autoexec.Bat file. 
  4337.  
  4338.      Be sure TbDriver has already been loaded - TbMem wil refuse to start up
  4339.      without it.
  4340.  
  4341.  
  4342.      Command line options
  4343.  
  4344.      It is possible to specify options on the command line. The upper four
  4345.      options are always available, the other options are available only if
  4346.      TbMem is not memory resident.
  4347.  
  4348.  
  4349.      option  parameter      short explanation
  4350.      --------------------------------------------------------------
  4351.      help                    ?    display this helpscreen
  4352.      off                     d    disable checking
  4353.      on                      e    enable checking
  4354.      remove                  r    remove TbMem from memory
  4355.  
  4356.      secure                  s    do not execute unauthorized TSRs 
  4357.      hotkey  <keycode>       k    specify keyboard scancode for hotkey
  4358.      nocancel                n    do not install cancel hot key
  4359.      nocmos                  m    do not protect CMOS
  4360.  
  4361.  
  4362.      help (?)
  4363.      If you specify this option TbMem will show you the brief help as shown
  4364.      above.
  4365.  
  4366.      off (d)
  4367.      If you specify this option TbMem will be disabled, but it will remain in
  4368.      memory.
  4369.  
  4370.  
  4371.  
  4372.                                      III - 38
  4373. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4374.  
  4375.  
  4376.      on (e)
  4377.      If you use this option TbMem will be activated again after you disabled
  4378.      it with the 'off' option.
  4379.  
  4380.      remove (r)
  4381.      This option can be used to remove the resident part of TbMem from your
  4382.      system's memory. All memory used by TbMem will be released. Unfortunate-
  4383.      ly, the removal of a TSR (like TbMem) is not always possible. TbMem
  4384.      checks whether it is safe to remove the resident part from memory. If it
  4385.      is not safe it just disables TbMem. A TSR can not be removed if another
  4386.      TSR has been started after it. If this happens with TbMem it will
  4387.      completely disable itself.
  4388.  
  4389.      secure (s)
  4390.      TbMem normally asks the user to continue or to cancel when a program
  4391.      tries to remain resident in memory. In some business environments
  4392.      however this choice should not be made by employees. By using option
  4393.      'secure' it is no longer possible to execute new or unknown resident
  4394.      software.
  4395.  
  4396.      nocancel (n)
  4397.      TbMem normally installs the program cancel hot key (Ctrl-Alt-Insert). If
  4398.      you do not want this, specify this option. This also saves a few bytes
  4399.      of memory.
  4400.  
  4401.      hotkey (k)
  4402.      TbMem offers you a reliable way to escape from any program by pressing a
  4403.      special key combination. This can be used to escape from programs that
  4404.      'hang', but of course also to escape from software that seems to be
  4405.      malicious (although powering down and rebooting from a write-protected
  4406.      system disk is recommended). 
  4407.  
  4408.      The program cancel hot key of TbMem is by default Ctrl-Alt-Insert. If
  4409.      you wish, you can specify another keyboard option with option 'hotkey
  4410.      =<keycode>'. The scancode is specified in a 4 digit hexadecimal number.
  4411.      The far left bytes specify the shift-key mask, the far right bytes
  4412.      specify the keyboard scancode. Consult your machine manual for a list of
  4413.      scancodes. The default scancode is 0C52h (Ctrl-Alt-Insert). The scancode
  4414.      for Ctrl-Alt-Escape is 0C01h.
  4415.  
  4416.      nocmos (m)
  4417.      TbMem normally protects the CMOS memory if available. If you do not want
  4418.      TbMem to do this you can specify this option.
  4419.  
  4420.      Examples
  4421.           C:\utils\TbMem
  4422.      or:
  4423.           Device=C:\utils\TbMem.Exe
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.                                      III - 39
  4430. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4431.  
  4432.  
  4433.      TbMem in process
  4434.  
  4435.      If TbMem detects that a program tries to remain resident in memory, a
  4436.      pop-up window will appear with a message. You can either choose to
  4437.      continue, or to abort the program invoca-tion. If you answer 'NO' to the
  4438.      question 'Remove program from memory?' the program will continue undis-
  4439.      turbed, and TbMem places a mark in the Anti-Vir.Dat file about this
  4440.      program. Next time you invoke the same resident program, TbMem will not
  4441.      disturb you again.
  4442.  
  4443.      There are a lot of programs which normally remain resident in memory,
  4444.      such as disk caches, print spoolers, etc. How does TbMem distinguish
  4445.      between these programs and viruses?
  4446.  
  4447.      TbMem uses the Anti-Vir.Dat records generated by TbSetup to keep track
  4448.      of which files are normal TSRs and which are not. Most common resident
  4449.      software will be marked as such by TbSetup, so you don't have to worry
  4450.      about these files. 
  4451.  
  4452.      If TbMem pops up with the message that a program tries to remain resi-
  4453.      dent in memory, you have to consider the purpose of the program mentio-
  4454.      ned. Is the program supposed to continue to operate in the background?
  4455.      The answer is obviously yes if the program mentioned is a disk cache,
  4456.      print spooler, pop-up utility or system extension software.
  4457.  
  4458.      However, if the message appears after you have finished a text proces-
  4459.      sing job, or terminated a database or spreadsheet application, something
  4460.      is definitely wrong! You ought to terminate the program and use a virus
  4461.      scanner to check the system.
  4462.  
  4463.      The same applies when software that operates normally without staying
  4464.      resident in memory suddenly changes its behavior and tries to remain
  4465.      resident in memory.
  4466.  
  4467.  
  4468. 5.2. TbFile
  4469.  
  4470.      The Purpose of TbFile
  4471.  
  4472.      The two most perilous viral categories are the bootsector and the file
  4473.      variants. File viruses all have a common purpose -they infect programs.
  4474.      Infecting a program involves very unusual file manipulations that are
  4475.      quite dissimilar to normal files handling procedures, so in order to
  4476.      detect viral activity it is essential to keep an eye out for program
  4477.      file changes involving peculiar actions.
  4478.  
  4479.      TbFile monitors the system and detects attempts of programs to infect
  4480.      other programs. Unlike other file guards, TbFile monitors the system
  4481.      only for virus specific file modifications. TbFile won't generate an
  4482.      alarm when a program modifies itself for configuration purposes, nor
  4483.      does it bother you when you update a program or create one yourself.
  4484.  
  4485.  
  4486.                                      III - 40
  4487. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4488.  
  4489.  
  4490.      Running an average system, configurations should never cause a false
  4491.      alarm.
  4492.  
  4493.      TbFile not only detects attempts to infect programs, it also offers you
  4494.      the option to abort the infection process and to continue the program.
  4495.  
  4496.      TbFile detects other suspicious activities - including setting the
  4497.      seconds value of time stamps to an illegal value.
  4498.  
  4499.      TbFile has a very sophisticated infection detector and it will not give
  4500.      a false alarm when you perform standard file operations. In normal
  4501.      configurations you will never get a false alarm! 
  4502.  
  4503.      Files can be protected against unwanted modifications by means of the
  4504.      read-only attribute. Without TbFile this standard DOS protection can be
  4505.      circumvented easily. TbFile however makes sure any attempts to sabotage
  4506.      the readonly attribute will not go undetected. This gives you added
  4507.      security by letting you use an uncomplicated method to fully protect
  4508.      your files against destruction and infection.
  4509.  
  4510.      TbFile is fully network compatible. It does not require you to reload
  4511.      the checker after logging on to a network. Other resident anti-virus
  4512.      utilities force you to choose between protection before the network is
  4513.      started, or protection after the network is started, but not both.
  4514.  
  4515.  
  4516.      Command line options
  4517.  
  4518.      It is possible to specify options on the command line. The upper four
  4519.      options are always available, the other options are only available if
  4520.      TbFile is not already memory-resident.
  4521.  
  4522.  
  4523.      option     short explanation
  4524.      ---------- ----------------------------
  4525.  
  4526.      help       ?     display this helpscreen
  4527.      off        d     disable checking
  4528.      on         e     enable checking
  4529.      remove     r     remove TbFile from memory
  4530.  
  4531.      secure     s     all permissions denied
  4532.      allattrib  a     readonly check on all files
  4533.  
  4534.  
  4535.      help (?)
  4536.      If you specify this option TbFile will show you the brief help as shown
  4537.      above.
  4538.  
  4539.      off (d)
  4540.      If you specify this option TbFile will be disabled, but it will remain
  4541.      in memory.
  4542.  
  4543.                                      III - 41
  4544. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4545.  
  4546.  
  4547.      on (e)
  4548.      If you use this option TbFile will be activated again after you disabled
  4549.      it with the 'off' option.
  4550.  
  4551.      remove (r)
  4552.      This option can be used to remove the resident part of TbFile from your
  4553.      system's memory.  All memory used by TbFile
  4554.      will be released.
  4555.      Unfortunately, the removal of a TSR (like TbFile) is not always possi-
  4556.      ble.  TbFile checks whether it is safe to remove the resident part from
  4557.      memory. If it is not safe it just disables TbFile. A TSR can not be
  4558.      removed if another TSR has been started after it. If this happens with
  4559.      TbFile it will completely disable itself.
  4560.  
  4561.      secure (s)
  4562.      TbFile normally asks the user to continue or to cancel when a program
  4563.      tries to perform a suspicious operation. In some business environments
  4564.      however this choice should not be made by employees. By using option
  4565.      'secure' it is no longer possible to allow suspicious operations.
  4566.  
  4567.      allattrib (a)
  4568.      TbFile normally only protects the readonly attribute of executables
  4569.      (program files with the extension COM and EXE). If you want to have the
  4570.      readonly check on all files add option 'allattrib'. In this case you
  4571.      will always get an alarm when an attempt is made to remove the readonly
  4572.      attribute of any file.
  4573.  
  4574.      Examples
  4575.           C:\utils\TbFile allattrib
  4576.      or:
  4577.           Device=C:\utils\TbFile.Exe allattrib
  4578.  
  4579.  
  4580. 5.3. TbDisk
  4581.  
  4582.      The Purpose of TbDisk
  4583.  
  4584.      Many viruses try to damage the data on the disk. They accomplish this by
  4585.      formatting the disk, overwriting the FAT, swapping disk sectors, etc.
  4586.      Almost anything is possible.
  4587.  
  4588.      Another category of malicious software, known as 'bootsector virus
  4589.      droppers', installs a bootsector virus on the disk. The program itself
  4590.      is not a virus, so detection with virus scanners and other anti-viral
  4591.      software is very difficult. The only way to detect such programs is by
  4592.      monitoring their behavior.
  4593.  
  4594.      The main problem lies in the way these programs manage to avoid the
  4595.      usual DOS procedures - they go directly to the BIOS, the Basic In-
  4596.      put/Output System. That is why you need TbDisk - to monitor the system
  4597.      and to ensure that no program can write directly to disk without permis-
  4598.      sion! It draws attention to any software that attempts to write directly
  4599.  
  4600.                                      III - 42
  4601. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4602.  
  4603.  
  4604.      to disk, thereby reducing the likelihood that a virus will remain
  4605.      unnoticed. TbDisk prevents viruses from damaging data on your disk and
  4606.      stops bootsector virus droppers in their tracks.
  4607.  
  4608.      TbDisk will come in handy, too, if you ever need to write protect a hard
  4609.      disk. This bonus feature often helps when testing new software.
  4610.  
  4611.      TbDisk not only informs you when a program tries to write directly to
  4612.      the disk, it also offers you the option to abort the program before it
  4613.      can cause any damage.
  4614.  
  4615.      Detection of 'stealth' techniques. TbDisk is able to detect attempts to
  4616.      single step through the BIOS handler, and even monitor the use of
  4617.      undocumented calls that could cause disk damage. 
  4618.  
  4619.      TbDisk is able to distinguish whether DOS or an application makes direct
  4620.      write attempts via Int 13h. Direct writes are perfectly legal for DOS,
  4621.      but unusual for application software. 
  4622.  
  4623.      TbDisk needs little maintenance. TbDisk uses the Anti-Vir.Dat records to
  4624.      determine if a program is allowed to write directly to the disk, inclu-
  4625.      ding popular disk utilities, which will have been recognized by TbSetup.
  4626.      In the absence of an Anti-vir.Dat record, TbDisk will ask your approval
  4627.      first and, if granted, updates the record accordingly in order to avoid
  4628.      repeated warnings about the same program.
  4629.  
  4630.      TbDisk is fully network compatible. It does not require you to reload
  4631.      the program after logging on to a network. Other resident anti-virus
  4632.      utilities force you to choose between either protection before the
  4633.      network is started, or protection after.
  4634.  
  4635.  
  4636.      How to use TbDisk
  4637.  
  4638.      Loading TBDisk
  4639.  
  4640.      Improper installation can cause excessive amounts of false alarms! If
  4641.      you want to install TbDisk in your Config.Sys or AutoExec.Bat file, it
  4642.      is highly recommended to use the 'install' option of TbDisk first. If
  4643.      the system continues to behave normally and TbDisk does not give false
  4644.      alarms when you copy files on your hard disk, TbDisk is installed
  4645.      correctly and you can remove option 'install'.
  4646.  
  4647.  
  4648.      TBDisk in your Install
  4649.  
  4650.      Failure to use option 'install' when you install TbDisk Config.Sys or
  4651.      AutoExec.Bat file may cause loss of data! Option 'install' causes TbDisk
  4652.      to allow all disk accesses, it will however pop-up a message like it
  4653.      would do in normal mode. If no false alarms occur when you copy files on
  4654.      your hard disk, TbDisk is installed correctly and option 'install' can
  4655.      be removed.
  4656.  
  4657.                                      III - 43
  4658. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4659.  
  4660.  
  4661.      If TbDisk causes false alarms you should load TbDisk further ahead in
  4662.      your Config.Sys or AutoExec.Bat file, until it works as it should do.
  4663.  
  4664.      Unlike the other TBAV utilities it is recommended to load TbDisk after
  4665.      other resident software!  Failure to do so can cause excessive amounts
  4666.      of false alarms!
  4667.  
  4668.  
  4669.      TBDisk and MS-Windows
  4670.  
  4671.      TbDisk detects if Windows is starting up, and will switch itself into
  4672.      multi tasking mode if necessary. You can even disable TbDisk in one
  4673.      window without affecting the functionality in another window.  If you
  4674.      configured Windows to use fast 32-bit disk access you might need TbDisk
  4675.      option 'win32' if Windows displays an error-message.
  4676.  
  4677.  
  4678.      Command line options
  4679.  
  4680.      It is possible to specify options on the command line. The upper four
  4681.      options are always available, the other options are available only if
  4682.      TbDisk is not memory resident.
  4683.  
  4684.  
  4685.      option    shortexplanation
  4686.      ------    -----------------------
  4687.  
  4688.      help      ?    display this helpscreen
  4689.      remove    r    remove TbDisk from memory
  4690.      off       d    disable checking
  4691.      on        e    enable checking
  4692.  
  4693.      wrprot    p    make hard disk write protected
  4694.      nowrprot  n    allow writes to hard disk
  4695.      win32     w    allow Windows 32bit disk access
  4696.      secure    s    deny access without asking
  4697.      nostealth a    do not detect stealth disk access
  4698.      notunnel  t    do not detect tunneling
  4699.      install   i    installation test mode
  4700.  
  4701.  
  4702.      help (?)
  4703.      If you specify this option TbDisk will show you the brief help as shown
  4704.      above. Once TbDisk has been loaded the help option will not show all
  4705.      options anymore.
  4706.  
  4707.      remove (r)
  4708.      This option can be used to remove the resident part of TbDisk from your
  4709.      system's memory.  All memory used by TbDisk will be released.
  4710.      Unfortunately, the removal of a TSR (like TbDisk) is not always possi-
  4711.      ble.  TbDisk checks whether it is safe to remove the resident part from
  4712.      memory. If it is not safe it just disables TbDisk. A TSR can not be
  4713.  
  4714.                                      III - 44
  4715. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4716.  
  4717.  
  4718.      removed if another TSR has been started after it. If this happens with
  4719.      TbDisk it will completely disable itself.
  4720.  
  4721.      off (d)
  4722.      If you specify this option TbDisk will be disabled, but it will remain
  4723.      in memory.
  4724.  
  4725.      on (e)
  4726.      If you use this option TbDisk will be activated again after you disabled
  4727.      it with the 'off' option.
  4728.  
  4729.      wrprot (p)
  4730.      Hard disks are more difficult to protect against writing than floppies,
  4731.      which adds considerably to the risks involved when, for instance,
  4732.      testing new software. Sometimes you might want to find out what this
  4733.      software will do to your hard disk and how this could possibly affect
  4734.      your valuable data. With option 'wrprot' it will be safer to do so.
  4735.      Whenever a program wishes to write to a protected disk you will receive
  4736.      a message such as:
  4737.  
  4738.      "Write protect error writing drive C: A)bort, R)etry, I)gnore?"
  4739.  
  4740.      You may then take appropriate action.
  4741.  
  4742. =>   Note: A software write protection solution is not absolutely reliable.
  4743.      It can be bypassed, but, fortunately, viruses that are actually capable
  4744.      to do so are few and far between. It can be a valuable shield against
  4745.      most malicious software, despite its shortcomings.
  4746.  
  4747.      nowrprot (n)
  4748.      You can use this option to undo the option 'wrprot'.
  4749.  
  4750.      win32 (w)
  4751.      Windows 386 Enhanced Mode uses some undocumented DOS calls to retrieve
  4752.      the original BIOS disk handler when 32-bit disk access has been enabled.
  4753.      Since TbDisk guards these calls, 32-bit disk access will no longer be
  4754.      possible, unless you specify option 'win32' when TbDisk is initialized. 
  4755.  
  4756. =>   Note: Use this option, which reduces antiviral security to some extent,
  4757.      only in Windows 386 Enhanced Mode with fast 32-bit disk access enabled!
  4758.  
  4759.      secure (s)
  4760.      TbDisk normally asks whether the user wants to continue or cancel when a
  4761.      program tries to perform direct disk access. In some business environ-
  4762.      ments, however, this should not be left up to employees. Option 'secure'
  4763.      disables direct disk access permission to new or unknown software.
  4764.  
  4765.      nostealth (a)
  4766.      TbDisk tries to detect direct calls into the BIOS. If such an  attempt
  4767.      occurs, TbDisk pops up with a message that the disk is accessed in an
  4768.      unusual way. If this feature causes false alarms, you can use this
  4769.      option to turn it off.
  4770.  
  4771.                                      III - 45
  4772. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4773.  
  4774.  
  4775.      notunnel (t)
  4776.      One of TbDisk's regular tasks is to detect tunneling attempts on the
  4777.      part of viruses. 'Tunneling' is a technique used by viruses to determine
  4778.      the location of the BIOS system code in memory, and to use that address
  4779.      to communicate with the BIOS directly. This will inactivate all TSR
  4780.      programs, including resident anti-virus software. TbDisk can detect
  4781.      'tunneling' attempts in advance and informs you about this. Some other
  4782.      antiviral products employ tunneling techniques also to bypass resident
  4783.      viruses, causing a false alarm. If you make use of such other anti-virus
  4784.      products, you may use the option 'notunnel' to disable tunneling-detec-
  4785.      tion.
  4786.  
  4787.      install (i)
  4788.      Incorrect installation may result in a large number of false alarms. You
  4789.      should use option 'install' when installing TbDisk, which will reduce
  4790.      the risk of cancelling a valid disk write operation as a result of false
  4791.      alarms.
  4792.  
  4793.  
  4794.      TbDisk in process
  4795.  
  4796.      What is Direct Disk Access?  
  4797.      Programs often access files, usually through the operating system (DOS).
  4798.      Whenever a program wants to update a file, for example, it asks DOS to
  4799.      write the data to disk. There are however also possibilities to write to
  4800.      a disk without using DOS. This is called 'direct disk access'.
  4801.  
  4802.      Normal programs do not write to the disk directly. However, there are
  4803.      some programs that need to write to disk directly. Programs in this
  4804.      category are:
  4805.  
  4806.      -    Format utilities. A disk can only be formatted by direct disk
  4807.           access.
  4808.  
  4809.      -    Disk diagnosis utilities (such as the NORTON disk doctor, DOS
  4810.           chkdsk, etc.)
  4811.  
  4812.      -    Disk optimizers.
  4813.  
  4814.      As many viruses are able to perform direct disk access as well, it is
  4815.      essential to have some control over all this. TbDisk can distinguish
  4816.      between legitimate programs and a virus with the help of the Anti-
  4817.      Vir.Dat records, generated by TbSetup under your guidance.
  4818.  
  4819.  
  4820.      Detecting direct disk accesses
  4821.  
  4822.      Whenever TbDisk pops up with the message that a program accesses to the
  4823.      disk directly, consider its purpose carefully. While it is perfectly
  4824.      acceptable for a format utility or a disk optimizer to format or edit
  4825.      disk sectors, the same cannot be said about a word processor or databa-
  4826.      se. When TbDisk warns you that a spreadsheet or some other 'normal'
  4827.  
  4828.                                      III - 46
  4829. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4830.  
  4831.  
  4832.      program is about to format a sector, you can be sure that something is
  4833.      wrong. Terminate the program -pronto!- and check things out with a virus
  4834.      scanner before the worst can happen.
  4835.  
  4836.  
  4837.  
  4838.  
  4839.  
  4840.  
  4841.  
  4842.  
  4843.  
  4844.  
  4845.  
  4846.  
  4847.  
  4848.  
  4849.  
  4850.  
  4851.  
  4852.  
  4853.  
  4854.  
  4855.  
  4856.  
  4857.  
  4858.  
  4859.  
  4860.  
  4861.  
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.                                      III - 47
  4886. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4887.  
  4888.  
  4889. 6. TBAV Tools
  4890.  
  4891.  
  4892. 6.1. TbUtil
  4893.  
  4894.      The Purpose of TbUtil
  4895.  
  4896.      TbUtil provides a defense against partition table and bootsector viru-
  4897.      ses:
  4898.  
  4899.      TbUtil copies the partition table, bootsector and CMOS data area into a
  4900.      file. On a regular base you can use TbUtil to compare both the current
  4901.      and the copied versions of the partition table, bootsector and CMOS data
  4902.      area. After a (virus) accident you can restore the copy with the TbUtil
  4903.      program. 
  4904.  
  4905.      TbUtil removes a partition table virus without having to low-level
  4906.      format the hard disk, even if there is no backup of the partition table.
  4907.  
  4908.      TbUtil removes bootsector viruses.
  4909.  
  4910.      TbUtil creates a partition table that has some first-line virus defenses
  4911.      built-in.
  4912.  
  4913.      TbUtil replaces the infected or clean bootsector by a safe TBAV boots-
  4914.      ector.
  4915.  
  4916.  
  4917.      What is a partition table?
  4918.  
  4919.      A partition is a logical drive on a hard disk. A physical hard disk can
  4920.      contain multiple DOS partitions. Every DOS partition has its own drive
  4921.      ID (eg. C: D: E:). The partition table contains the disk lay-out and the
  4922.      start and end cylinder of every partition. The partition table also
  4923.      carries information about the operating system of a partition and which
  4924.      partition should be used to boot. The partition table is always located
  4925.      at the first sector of the hard disk. It is called the "Master Boot
  4926.      Record".
  4927.  
  4928.  
  4929.      No format needed
  4930.  
  4931.      Unlike most file viruses, partition table viruses are hard to remove.
  4932.      The only solution is to low-level format the hard disk and to make a new
  4933.      partition table, or to make use of undocumented DOS commands.
  4934.  
  4935.      TbUtil makes a backup of the partition table and bootsector, and will
  4936.      use this backup to compare and restore both the original partition table
  4937.      and bootsector once they have been infected. You don't have to format
  4938.      your disk anymore to get rid of a partition table or bootsector virus.
  4939.      The program can also restore the CMOS configuration.
  4940.  
  4941.  
  4942.                                      III - 48
  4943. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  4944.  
  4945.  
  4946.      If desired TbUtil replaces the partition table code with an immunized
  4947.      partition table, containing facilities against viruses. The TbUtil
  4948.      partition code will be executed before the bootsector gains control, so
  4949.      it is able to check the bootsector in a clean environment. Once the
  4950.      bootsector is executed it is difficult to check it, because the virus is
  4951.      already resident in memory and can fool any protection. Instead of
  4952.      booting from a clean DOS diskette just to inspect the bootsector, the
  4953.      TbUtil partition code performs a CRC calculation on the bootsector just
  4954.      before control is passed to it.
  4955.  
  4956.      If the bootsector has been modified the TbUtil partition code will warn
  4957.      you about this. The TbUtil partition code also checks the RAM layout and
  4958.      informs you when it has changed. It does this every time you boot from
  4959.      your hard disk.
  4960.  
  4961.      TbUtil can replace infected and clean diskette bootsectors by a new
  4962.      bootsector, which has advantages over the standard bootsector. It has
  4963.      bootsector virus detection capabilities, it performs a sanity check, and
  4964.      it offers you the possibility to redirect the boot process to the hard
  4965.      disk without opening the diskette drive door.
  4966.  
  4967.  
  4968.      How to use TbUtil
  4969.  
  4970.      The TbUtil module contains several programs, which can be executed from
  4971.      the TbUtil menu or in case of an emergency from a TbUtil recovery
  4972.      diskette using the DOS command line. TbUtil allows some additional menu
  4973.      options. These options are discussed below. The corresponding command
  4974.      line parameters are listed in chapter 6 of this section.
  4975.  
  4976.  
  4977.      The system maintenance menu
  4978.  
  4979.      This menu contains the actual TbUtil program. The program takes care of
  4980.      saving, restoring or comparing the system configuration of your PC. The
  4981.      backup system configuration is stored on a diskette in a file with
  4982.      either a default name or a name you can specify yourself.
  4983.  
  4984. =>   Warning: You can only restore a system configuration datafile on the
  4985.      machine which created the datafile. If not, restoring such a file will
  4986.      make your PC inaccessible!
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.                                      III - 49
  5000. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5001.  
  5002.  
  5003.      +----Main menu-----+
  5004.      |  Confi+-----------TbUtil menu-----------+
  5005.      |  TbSet|  Syste+-------System maintenance-------+
  5006.      |  TbSca|  Immun|  Execute TbUtil                |
  5007.      |  TbUti|  Immun|  Name of TbUtil data file      |
  5008.      |  TbCLe|  Immun|  Describe this machine         |
  5009.      |  TBAV +-------|  Save system configuration     |
  5010.      |  Documentation|v Compare system configuration  |
  5011.      |  Quit and save|  Restore system configuration  |
  5012.      |  eXit (no save|v process CMOS memory           |
  5013.      +---------------|v process Partition code        |
  5014.                      |v process Bootsector            |
  5015.                      +--------------------------------+
  5016.  
  5017.  
  5018.      Execute TbUtil
  5019.  
  5020.      Before activating this option, you must select one of the optional
  5021.      functions: save, compare or restore the system configuration. Toggle to
  5022.      the desired option and type <ENTER>. A checkmark will indicate the
  5023.      selected option.
  5024.  
  5025.  
  5026.      Name of TbUtil data file
  5027.  
  5028.      With the 'Save' option, the system configuration is saved in a file. You
  5029.      can add a description to this TbUtil data file, which makes it easier to
  5030.      determine which datafile belongs to which machine.
  5031.  
  5032.  
  5033.      Describe this machine 
  5034.  
  5035.      Enter a meaningful description of the machine. Enter something like "AT
  5036.      12MHz, 4Mb, room 12, Mr. Smith". You do NOT have to remember it, TbUtil
  5037.      will display it on the screen when comparing or restoring, but it helps
  5038.      you to verify that the data file belongs to the machine.
  5039.  
  5040.  
  5041.      Save system configuration 
  5042.  
  5043.      This option stores the partition table, bootsector and CMOS data area
  5044.      into the TbUtil data file. 
  5045.  
  5046. =>>  Attention! Since the PC is completely inaccessible to DOS if the parti-
  5047.      tion table gets damaged, it is HIGHLY RECOMMENDED to store both the
  5048.      TbUtil data file and the program TbUtil.Exe itself on a diskette! It is
  5049.      not nice if the partition table is destroyed and the only solution to
  5050.      the problem resides on the same inaccessible disk...
  5051.  
  5052.      When loading TbUtil from the command line you must specify a filename
  5053.      after the 'store' option. Using the TBAV menu, you may use the default
  5054.      filename 'TBUTIL.DAT'. If you own more than one PC, it is advisable to
  5055.  
  5056.                                      III - 50
  5057. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5058.  
  5059.  
  5060.      create one TbUtil diskette with all TbUtil data files of all your PC's
  5061.      on it. Use the extension of the file for PC identification, eg.:
  5062.  
  5063.           a:TbUtil.<number>
  5064.  
  5065.  
  5066.      Compare system configuration 
  5067.  
  5068.      This option enables you to check on a regular basis that everything is
  5069.      still OK. If you specify this option TbUtil will compare the information
  5070.      in the TbUtil data file against the partition table, bootsector and CMOS
  5071.      data area. It will also  show the comment stored in the data file. And
  5072.      of course, if you use this option you will also be guaranteed that the
  5073.      TbUtil data file is still readable.
  5074.  
  5075.  
  5076.      Restore system configuration 
  5077.  
  5078.      This option enables you to restore the partition table, bootsector, and
  5079.      CMOS data area. It will ask you to confirm that the data file belongs to
  5080.      the current machine. Finally it will restore the partition table,
  5081.      bootsector of the partition to be used to boot, and the CMOS data area.
  5082.  
  5083.  
  5084.      Process Partition code/Bootsector/CMOS memory
  5085.  
  5086.      TbUtil will by default restore the partition code, bootsector and CMOS
  5087.      if option 'restore' is specified. If you use one of the above mentioned
  5088.      options in combination with the option 'restore' TbUtil will restore
  5089.      just the items specified.
  5090.  
  5091.  
  5092.  
  5093.      The TbUtil menu
  5094.  
  5095.      Apart from the System maintenance menu, the TbUtil menu contains some
  5096.      useful programs to prevent bootsector virus infection or to remove these
  5097.      viruses.
  5098.  
  5099.      +----Main menu-----+
  5100.      |  Confi+-----------TbUtil menu-----------+
  5101.      |  TbSet|  System maintenance menu       >|
  5102.      |  TbSca|  Immunize/clean bootsector A:   |
  5103.      |  TbUti|  Immunize/clean bootsector B:   |
  5104.      |  TbCLe|  Immunize/clean partition code  |
  5105.      |  TBAV +---------------------------------+
  5106.      |  Documentation  >|
  5107.      |  Quit and save   |
  5108.      |  eXit (no save)  |
  5109.      +------------------+
  5110.  
  5111.  
  5112.  
  5113.                                      III - 51
  5114. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5115.  
  5116.  
  5117.      Immunize/clean diskette 
  5118.  
  5119.      You can use the 'immunize' program to clean diskettes infected by a
  5120.      bootsector virus or to replace the standard bootsector by a bootsector
  5121.      which has advantages over the original one:
  5122.  
  5123.      It has virus detection capabilities. The bootsector will check that it
  5124.      is still located on the correct place on the diskette, and that Int 13h
  5125.      and/or Int 40h are still located in system ROM. This makes it possible
  5126.      to detect even 'stealth' and bootsector viruses.
  5127.  
  5128.      The TBAV bootsector is able to load the system files if they are availa-
  5129.      ble on the disk, but if the DOS system files are not on the disk the
  5130.      TBAV bootsector will present a small menu and offers you two possibili-
  5131.      ties: retry the boot operation with another diskette, or to boot from
  5132.      the harddisk. If the user selects the latter, it is not required to open
  5133.      the diskette drive door.
  5134.  
  5135.  
  5136.      Immunize/clean hard disk 
  5137.  
  5138.      This is a very powerful option, which can be used to clean an infected
  5139.      partition table if there is no TbUtil data file. It replaces the exis-
  5140.      ting partition table code by a new partition routine containing some
  5141.      virus detection capabilities. The original partition code will be saved
  5142.      in a file. You have to execute TbUtil from a floppy drive or you have to
  5143.      specify the name of the file (the specified drive should be a diskette
  5144.      drive) to store the original partition code.
  5145.  
  5146.      If the original partition table is completely damaged and cannot be used
  5147.      to build a new one, TbUtil will scan the entire disk for information
  5148.      about the original disk layout. TbUtil will also search for TbUtil data
  5149.      files on the hard disk. It is however recommended to store the data file
  5150.      on a diskette, although it is a good idea to keep a copy of it on the
  5151.      hard disk. Just in case!
  5152.  
  5153.      If your system configuration changes, i.e. you update your DOS version,
  5154.      or change the amount of memory, you need to update the information
  5155.      stored in the immune partition as well. You can do this by using this
  5156.      option.
  5157.  
  5158.      In the unlikely event that the system does not boot properly, you can
  5159.      restore the original partition table using the TbUtil 'restore' option
  5160.      or by using the DOS 5+ 'FDISK /MBR' command (which will create a new
  5161.      partition table).
  5162.  
  5163.      If the new partition code works properly, you should make a back-up copy
  5164.      of it on a diskette using the TbUtil 'store' option.
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.                                      III - 52
  5171. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5172.  
  5173.  
  5174.      Command line options
  5175.  
  5176.      TbUtil recognizes option-characters and option-words. The words are
  5177.      easier to remember, and they will be used in this manual for convenien-
  5178.      ce.
  5179.  
  5180.  
  5181.      option     parameter   short explanation
  5182.      ------     ---------   ----  --------------------
  5183.  
  5184.      immunize   <drive>       im  Immunize/Clean boot/MBR of <drive>
  5185.      store      [<filename>]  st  Store system information
  5186.      restore    [<filename>]  re  Restore system information
  5187.      compare    [<filename>]  co  Compare system information
  5188.      Sub-options of option 'Immunize':
  5189.      norepeat                 nr  Do not ask for next diskette
  5190.      Sub-options of option 'Store':
  5191.      description<descr.>      de  Add description to data file
  5192.      Sub-options of option 'Restore':
  5193.      part                     pt  Restore partition table
  5194.      boot                     bo  Restore bootsector of HD
  5195.      cmos                     cm  Restore CMOS
  5196.  
  5197.  
  5198.      Below, the command line options are explained briefly.
  5199.  
  5200.      immunize diskette <drive> (im)
  5201.      You can use the 'immunize' program to clean diskettes infected by a
  5202.      bootsector virus or to replace the standard bootsector by a bootsector
  5203.      which has advantages over the original one: 
  5204.  
  5205.      -    It has virus detection capabilities. The bootsector will check that
  5206.           it is still located on the correct place on the diskette, and that
  5207.           Int 13h and/or Int 40h are still located in system ROM. This makes
  5208.           it possible to detect even 'stealth' and bootsector viruses.
  5209.  
  5210.      -    The TBAV bootsector is able to load the system files if they are
  5211.           available on the disk, but if the DOS system files are not on the
  5212.           disk the TBAV bootsector will present a small menu and offers you
  5213.           two possibilities: retry the boot operation with another diskette,
  5214.           or to boot from the harddisk. If the user selects the latter, it is
  5215.           not required to open the diskette drive door.
  5216.  
  5217.  
  5218.      Immunize c: (im c:)
  5219.      This is a very powerful option, which can be used to clean an infected
  5220.      partition table if there is no TbUtil data file. It replaces the exis-
  5221.      ting partition table code by a new partition routine containing some
  5222.      virus detection capabilities. The original partition code will be saved
  5223.      in a file. You have to execute TbUtil from a floppy drive or you have to
  5224.      specify the name of the file (the specified drive should be a diskette
  5225.      drive) to store the original partition code.
  5226.  
  5227.                                      III - 53
  5228. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5229.  
  5230.  
  5231.      If the original partition table is completely damaged and cannot be used
  5232.      to build a new one, TbUtil will scan the entire disk for information
  5233.      about the original disk layout. TbUtil will also search for TbUtil data
  5234.      files on the hard disk. It is however recommended to store the data file
  5235.      on a diskette, although it is a good idea to keep a copy of it on the
  5236.      hard disk. Just in case!
  5237.  
  5238.      If your system configuration changes, i.e. you update your DOS version,
  5239.      or change the amount of memory, you need to update the information
  5240.      stored in the immune partition as well. You can do this by using this
  5241.      option. In the unlikely event that the system does not boot properly,
  5242.      you can restore the original partition table using the TbUtil 'restore'
  5243.      option or by using the DOS 5+ 'FDISK /MBR' command (which will create a
  5244.      new partition table). If the new partition code works properly, you
  5245.      should make a back-up copy of it on a diskette using the TbUtil 'store'
  5246.      option.
  5247.  
  5248.      store [<filename>] (st)
  5249.      This option stores the partition table, bootsector and CMOS data area
  5250.      into the TbUtil data file. 
  5251.  
  5252. =>>  Attention! Since the PC is completely inaccessible to DOS if the parti-
  5253.      tion table gets damaged, it is HIGHLY RECOMMENDED to store both the
  5254.      TbUtil data file and the program TbUtil.Exe itself on a diskette! It is
  5255.      not nice if the partition table is destroyed and the only solution to
  5256.      the problem resides on the same inaccessible disk...
  5257.  
  5258.      When loading TbUtil from the command line you must specify a filename
  5259.      after the 'store' option. Using the TBAV menu, you may use the default
  5260.      filename 'TBUTIL.DAT'. If you own more than one PC, it is advisable to
  5261.      create one TbUtil diskette with all TbUtil data files of all your PC's
  5262.      on it. Use the extension of the file for PC identification, eg.:
  5263.      a:TbUtil.<number>
  5264.  
  5265.      restore [<filename>] (re)
  5266.      This option enables you to restore the partition table, bootsector, and
  5267.      CMOS data area. It will ask you to confirm that the data file belongs to
  5268.      the current machine. Finally it will restore the partition table,
  5269.      bootsector of the partition to be used to boot, and the CMOS data area.
  5270.  
  5271.      compare [<filename>] (co)
  5272.      This option enables you to check on a regular basis that everything is
  5273.      still OK. If you specify this option TbUtil will compare the information
  5274.      in the TbUtil data file against the partition table, bootsector and CMOS
  5275.      data area. It will also  show the comment stored in the data file. And
  5276.      of course, if you use this option you will also be guaranteed that the
  5277.      TbUtil data file is still readable.
  5278.  
  5279.      norepeat (nr) 
  5280.      TbUtil will prompt you for next diskette after you immunized a diskette.
  5281.      With option 'norepeat' you can disable this.
  5282.  
  5283.  
  5284.                                      III - 54
  5285. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5286.  
  5287.  
  5288.      description <descr.> (de)
  5289.      Enter a meaningful description of the machine. Enter something like "AT
  5290.      12MHz, 4Mb, room 12, Mr. Smith". You do NOT have to remember it, TbUtil
  5291.      will display it on the screen when comparing or restoring, but it helps
  5292.      you to verify that the data file belongs to the machine.
  5293.  
  5294.      part (pt)
  5295.      boot (bo)
  5296.      cmos (cm)
  5297.  
  5298.      TbUtil will by default restore the partition code, bootsector and CMOS
  5299.      if option 'restore' is specified. If you use one of the above mentioned
  5300.      options in combination with the option 'restore' TbUtil will restore
  5301.      just the items specified.
  5302.  
  5303.  
  5304.      Examples
  5305.           TbUtil store
  5306.           TbUtil st
  5307.           TbUtil store A:TbUtil.Dat
  5308.           TbUtil store A:TbUtil.Dat description = "Test machine"
  5309.           TbUtil compare A:TbUtil.Dat
  5310.           TbUtil restore A:TbUtil.Dat part cmos
  5311.           TbUtil immunize A:
  5312.           Type A:TbUtil.Dat
  5313.  
  5314.  
  5315.      Using the anti-virus partition
  5316.  
  5317.      If you install the Thunderbyte partition code (TbUtil immunize), you
  5318.      will see the following while booting a clean system:
  5319.  
  5320.  
  5321.           Thunderbyte anti-virus partition v6.03 (C) 1993 Thunderbyte BV.
  5322.  
  5323.           Checking bootsector CRC -> OK!
  5324.           Checking available RAM -> OK!
  5325.           Checking INT 13h -> OK!
  5326.  
  5327.  
  5328.      If there is a virus in the bootsector or partition table you will see
  5329.      this:
  5330.  
  5331.           Thunderbyte anti-virus partition v6.03 (C) 1993 Thunderbyte BV.
  5332.  
  5333.           Checking bootsector CRC -> OK!
  5334.           Checking available RAM -> Failed!
  5335.  
  5336.           System might be infected. Continue? (N/Y)
  5337.  
  5338.  
  5339.  
  5340.  
  5341.                                      III - 55
  5342. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5343.  
  5344.  
  5345.      Some other messages that can be displayed are "No system.", which means
  5346.      that there is no active partition on the disk, and "Disk error" of which
  5347.      the meaning is obvious.
  5348.  
  5349.  
  5350.      Using the TbUtil diskette
  5351.  
  5352.      Take a new diskette, format it as a bootable diskette (eg. by using the
  5353.      dos 'format /s' command). Copy the TbUtil files onto the diskette:
  5354.  
  5355.           copy tbutil.* a:
  5356.  
  5357.      The TbUtil files you need are:
  5358.           tbutil.exe
  5359.           tbutil.lng
  5360.  
  5361.      'Tbutil.doc' is a documentation file which is not necessarily needed,
  5362.      but it might be of some assistance to you.
  5363.  
  5364.  
  5365.      Trouble-Shooting
  5366.  
  5367.      In case of an emergency, eg. a damaged or infected partition table, you
  5368.      should boot from the TbUtil diskette. Subsequently, you start the TbUtil
  5369.      program, using the 'immunize' option:
  5370.  
  5371.           a:\tbutil immunize c:
  5372.  
  5373.  
  5374.  
  5375. 6.2. StackMan
  5376.  
  5377.      Purpose of Stackman
  5378.  
  5379.      Have you ever experienced your machine hanging unexpectedly? Have you
  5380.      ever experienced programs dumping beeping garbage on the screen? Ever
  5381.      found your overnight working machine hanging when you return to work
  5382.      even though the same programs work well during the day? Ever seen the
  5383.      message "Stack overflow"? Ever found some resident or background softwa-
  5384.      re to hang the machine as soon as you want to activate them? Does your
  5385.      system run unreliably when you put the statement "Stacks=0,0" in your
  5386.      Config.Sys file? Do some programs crash when using them in combination
  5387.      with some TSR's?
  5388.  
  5389.      If you can answer all these questions with "No" the Stack Manager will
  5390.      not be useful for you. If some of these events frequently happen to you,
  5391.      these problems are probably caused by stack over-flows. Mostly these
  5392.      problems can be solved by using the Config.Sys statement "Stacks 9,256".
  5393.      Sometimes they cannot. Anyway, the "Stacks" statement consumes precious
  5394.      memory and it is hard to guess the correct values. The "Stacks" state-
  5395.      ment is not explained very well in most manuals. Only a few users seem
  5396.      to understand its purpose.
  5397.  
  5398.                                      III - 56
  5399. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5400.  
  5401.  
  5402.  
  5403.      What is a stack?
  5404.  
  5405.      A stack is a memory buffer used by software and the procesor itself to
  5406.      store temporary data. All programs establish a stack when they are
  5407.      executed. Background or resident software have to use the stack of the
  5408.      foreground program as well. As soon as you press a key the processor is
  5409.      interrupted by the keyboard processor to fetch the pressed key. With
  5410.      every timer tick the processor is interrupted to increase the system
  5411.      timer. All these background processes consume some stack space. 
  5412.  
  5413.  
  5414.      How does it fail?
  5415.  
  5416.      Sometimes a timer tick, a keyboard interrupt and another interrupt all
  5417.      occur at the same time. It will not happen often, but when it happens,
  5418.      all these processes need some stack space at the very same time. If no
  5419.      more stack space is available the system will simply hang... And as you
  5420.      might expect, these random events are hard to reproduce...
  5421.  
  5422.      Although it is recommended to supply plenty of stack space in a program,
  5423.      many programmers keep the stack very small to save memory, especially if
  5424.      the program is intended to remain resident in memory.  Of course resi-
  5425.      dent programs can set up their own temporary stack as soon as they are
  5426.      activated, but before they are able to do that they need to use some of
  5427.      the foreground stack space, and the resident stack is often also very
  5428.      small for obvious reasons. If you have a lot of resident software and/or
  5429.      background software the stack might be too small in some cases.
  5430.  
  5431.      To avoid these problems DOS is able to maintain a stack pool and it
  5432.      switches to a dedicated stack if a hardware interruptoccurs. The
  5433.      "Stacks" statement in the Config.Sys can be used to control this stack
  5434.      pool.
  5435.  
  5436.      The DOS stack switching however, has some drawbacks and this is one of
  5437.      the reasons why StackMan has been developed.
  5438.  
  5439.      StackMan offers the same functionality as the DOS "Stacks" command, but
  5440.      in addition to this:
  5441.  
  5442.      If you use DOS 5 or higher, StackMan can be loaded high and/or into the
  5443.      HMA. DOS instead always maintains the stack pool in conventional memory.
  5444.      When using StackMan you free up about 1.5Kb of memory.
  5445.  
  5446.      The parameters of StackMan are more flexible. You can define just one
  5447.      stack frame if it is sufficient. The minimum of DOS is 8.
  5448.  
  5449.      StackMan can be loaded AFTER your TSR's become resident. This causes the
  5450.      TSR's to use the stackspace provided by StackMan. The DOS stacks pool
  5451.      however is only available for the DOS and BIOS code. TSR's still use the
  5452.      foreground program's stack, and if this causes problems the DOS stacks
  5453.      command will not solve this.
  5454.  
  5455.                                      III - 57
  5456. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5457.  
  5458.  
  5459.      The DOS stacks command offers the user a type of roulette: the only way
  5460.      to find the correct values is by trial and error. StackMan can print a
  5461.      report and it is easy to find out the stack requirements of your system
  5462.      configuration. It is easy to fine-tune the StackMan parameters to suit
  5463.      your system configuration perfectly.
  5464.  
  5465.      Sometimes DOS stacks seem to disappear. Although this can be considered
  5466.      as a bug from one of the TSR's or foreground programs it is hard to deal
  5467.      with the resulting DOS message "Stack overflow. System halted". This
  5468.      never happens immediately but a short while after the offending program
  5469.      corrupted a stack. StackMan however recognizes this situation and it
  5470.      will automatically recover the lost stack without interrupting the
  5471.      program.
  5472.  
  5473.      Although StackMan can be used to replace the DOS stacks command it has
  5474.      additional features:
  5475.  
  5476.      In some cases the total stack requirements of all resident int 21h
  5477.      handlers may exceed the available stack space, especially when using a
  5478.      program that maintains a tiny stack (like some popular swap utilities).
  5479.      Although these programs may perform well at the machine of the develo-
  5480.      per, many other users may experience problems. StackMan can be used to
  5481.      force a normal stack space for DOS at all times.
  5482.  
  5483.  
  5484.      To be safe TSR's should maintain their own stack, but that means that
  5485.      the TSR program would occupy some extra memory to hold the stack.
  5486.      Because a dedicated stack is only necessary on a few systems, this would
  5487.      normally be a waste of your precious memory. StackMan has been designed
  5488.      to handle stack requests of TSR programs to solve this problem. Many TSR
  5489.      programs can share a few of the stacks provided by StackMan. The stack
  5490.      is available when the TSR activates, and gone as soon as the TSR resumes
  5491.      system control. It just saves memory...
  5492.  
  5493.  
  5494.      How to use StackMan
  5495.  
  5496.      Before using StackMan it is recommended to put the statement
  5497.      "Stacks=0,0" into the Config.Sys file. Using any other (or the default
  5498.      values) just causes DOS to waste memory.
  5499.  
  5500.      The syntax of StackMan is:
  5501.  
  5502.           StackMan [[=] <num of stacks),<stack size>] [<options...>]
  5503.  
  5504.      The best location to load StackMan is at the end of your Autoexec.Bat
  5505.      file. This way resident software will use the stacks provided by Stack-
  5506.      Man automatically. You can highload StackMan if you want to. As a first
  5507.      test it is recommended to use large values like:
  5508.  
  5509.           StackMan = 18,384
  5510.  
  5511.  
  5512.                                      III - 58
  5513. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5514.  
  5515.  
  5516.      Now use the system as you do normally and test if some of the problems
  5517.      are solved. Invoke all TSR's you have and try also to activate multiple
  5518.      TSR's at the same time. Use your modem, mouse, etc. It is not necessary
  5519.      to execute large programs since they have their own stack and they will
  5520.      not affect the results of StackMan.
  5521.  
  5522.      Now execute StackMan again. You should see a message like this:
  5523.  
  5524.           StackMan already installed, with 18 stacks of 384 bytes.Maximum
  5525.           stacks/space ever used:  6 stacks of 112 bytes.
  5526.  
  5527.  
  5528.      You now can reduce the parameter values of StackMan. It is highly
  5529.      recommended to maintain some extra overhead. "Special events" are very
  5530.      hard to reproduce. Reliable values for this example are: "StackMan =
  5531.      8,192".
  5532.  
  5533.      If the first value of the StackMan report is below or equal to 3 and the
  5534.      second does not exceed 48 you can use your system without StackMan. In
  5535.      other cases unlikely events are able to crash the machine and you should
  5536.      use StackMan to avoid random problems.
  5537.  
  5538.      It is recommended to check the output of StackMan once in a while to
  5539.      fine-tune the system and anticipate on increasing stack requirements of
  5540.      your configuration.
  5541.  
  5542.      If still some of the problems occur you can test if the -dos parameter
  5543.      solves it. Specify this on the command line after a reboot:
  5544.  
  5545.           StackMan = 18,384 -dos -noirq
  5546.  
  5547.      The report of StackMan should now be treated differently: the first
  5548.      value will always show the maximum stacks amount available, only the
  5549.      stackspace used is reliable. If this value exceeds 48 you should consi-
  5550.      der the use of the -dos option of StackMan.
  5551.  
  5552.      If the first test shows that you have to use StackMan anyway you should
  5553.      remove the -noirq option. If only DOS needs StackMan you can keep this
  5554.      parameter. If you use the -dos option you should allocate two extra
  5555.      stack frames in addition to the values achieved by the first test.
  5556.  
  5557.  
  5558.      Command line options
  5559.  
  5560.      It is possible to specify options on the command line.
  5561.  
  5562.      -help
  5563.      This option shows a little help screen.
  5564.  
  5565.  
  5566.  
  5567.  
  5568.  
  5569.                                      III - 59
  5570. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.               SECTION III
  5571.  
  5572.  
  5573.      -dos
  5574.      This option causes StackMan to force a fresh stack before entering DOS.
  5575.      This may solve some problems, especially if they occur at program
  5576.      startup or termination or in combination with swapping shell programs.
  5577.  
  5578.      -noirq
  5579.      If you specify this option StackMan will not switch the stack after an
  5580.      interrupt occurs. The only functionality left in this case is the -dos
  5581.      option and the stack sharing of StackMan-supporting TSR programs.
  5582.  
  5583.      -hma
  5584.      This option can only be specified if you are using DOS 5+ when DOS is
  5585.      loaded into the HMA (with the dos=high statement). You cannot use this
  5586.      option in combination with the -dos option. The -hma option causes
  5587.      StackMan to keep the stacks in the HMA space left by DOS. Although this
  5588.      saves memory you should test very thoroughly if your system allows the
  5589.      use of the HMA by StackMan.
  5590.  
  5591.  
  5592.  
  5593.  
  5594.  
  5595.  
  5596.  
  5597.  
  5598.  
  5599.  
  5600.  
  5601.  
  5602.  
  5603.  
  5604.  
  5605.  
  5606.  
  5607.  
  5608.  
  5609.  
  5610.  
  5611.  
  5612.  
  5613.  
  5614.  
  5615.  
  5616.  
  5617.  
  5618.  
  5619.  
  5620.  
  5621.  
  5622.  
  5623.  
  5624.  
  5625.  
  5626.                                      III - 60
  5627. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  5628.  
  5629.  
  5630. SECTION IV. ADVANCED USER INFORMATION
  5631.  
  5632.  
  5633. 1. Memory requirements
  5634.  
  5635.      Free memory needed:
  5636.                               min.                min.
  5637.                               to be               after
  5638.                               loaded:             termination:
  5639.  
  5640.      TbScan                   200 Kb
  5641.      TbScanX                  10 Kb               800 bytes
  5642.      TbCheck                  4 Kb                600 bytes
  5643.      TbUtil                   64 Kb
  5644.      TbClean                  96 Kb
  5645.  
  5646.      TbMem                    4 Kb                600 bytes
  5647.      TbFile                   5 Kb                2 Kb
  5648.      TbDisk                   4 Kb                800 bytes
  5649.      TbDriver                 5 Kb                3 Kb
  5650.  
  5651.      TbGarble                 4 Kb                600 bytes
  5652.  
  5653.  
  5654.      If you decide to use a log file TbScan will need an additional 16 Kb of
  5655.      memory for the log file buffer. If TbScan uses its own built-in file
  5656.      system it uses additional memory to keep the FAT in memory.
  5657. =>   Note that the memory requirements are independent of the number of
  5658.      signatures. The current memory requirements are adequate to manage at
  5659.      least 2500 signatures.
  5660.  
  5661.      The amount of memory TbScanX requires depends on the number of signatu-
  5662.      res. With all features enabled TbScanX uses 30 Kb of memory when scan-
  5663.      ning for 1000 family signatures. If you enable swapping TbScanX normally
  5664.      uses only 1Kb of memory. You can swap to EMS and XMS memory. Of course
  5665.      the remaining kilobyte of TbScanX can be loaded in upper memory.
  5666.  
  5667.      In the heuristic cleaning mode TbClean needs much more memory, depending
  5668.      on the size of the infected file. TbClean can also use expanded memory
  5669.      (EMS).
  5670.  
  5671.  
  5672.      Reducing memory requirements
  5673.  
  5674.      Most PC users try to maintain as much free DOS memory as possible. The
  5675.      memory resident TBAV utilities (TbScanX, TbCheck, TbMem, TbFile, TbDisk
  5676.      and TbDriver) are designed to use only a little amount of DOS memory. To
  5677.      decrease the memory requirements of these utilities even further do the
  5678.      following:
  5679.  
  5680.  
  5681.  
  5682.  
  5683.                                       IV - 1
  5684. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  5685.  
  5686.  
  5687.      Load the program from within the Config.Sys file. If loaded as a device
  5688.      driver it has no Program Segment Prefix (PSP), which saves 256 bytes for
  5689.      each TBAV utility.
  5690.  
  5691.      If you load the TBAV utilities from within the Autoexec.Bat file, load
  5692.      them before establishing environment variables. DOS maintains a list of
  5693.      environment variables for every resident program, so keep this list
  5694.      small while installing TSRs. Once all TSRs are installed you can define
  5695.      all environment variables without affecting the memory requirements of
  5696.      the TSRs.
  5697.  
  5698.  
  5699.      Use swapping. 
  5700.  
  5701.      By using one of the options 'ems' or 'xms' TbScanX swaps itself to non-
  5702.      DOS memory, leaving only 1 Kb of code in DOS memory. Swapping to expan-
  5703.      ded memory ('ems') is preferred. 
  5704.  
  5705.      If you have DOS 5 or higher try to load the program into an upper memory
  5706.      block using the "loadhigh" or "devicehigh" commands. It is recommended
  5707.      to enable swapping also to limit the usage of upper memory.
  5708.  
  5709.      Use one of the processor specific versions of the relevant TBAV utility.
  5710.      They all consume less memory than the generic versions. Processor
  5711.      optimized versions are available on any ThunderBYTE support BBS.
  5712.  
  5713.  
  5714.  
  5715.  
  5716.  
  5717.  
  5718.  
  5719.  
  5720.  
  5721.  
  5722.  
  5723.  
  5724.  
  5725.  
  5726.  
  5727.  
  5728.  
  5729.  
  5730.  
  5731.  
  5732.  
  5733.  
  5734.  
  5735.  
  5736.  
  5737.  
  5738.  
  5739.  
  5740.                                       IV - 2
  5741. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  5742.  
  5743.  
  5744. 2. TbSetup
  5745.  
  5746.  
  5747. 2.1. Anti-Vir.Dat design considerations
  5748.  
  5749.      ThunderBYTE Anti-Virus expects every directory on your system with
  5750.      executable files to have its own Anti-Vir.Dat file. Some other anti-
  5751.      virus products maintain a somewhat similar 'fingerprint' list of all
  5752.      executable files, but in one large file rather than a separate file in
  5753.      every directory. TBAV contains a separate file in every directory
  5754.      instead of one file with all file information because of the following:
  5755.  
  5756.      One file in every directory will ease maintenance. If you want to remove
  5757.      a complete product, the accompanying Anti-Vir.Dat file can be removed as
  5758.      well. 
  5759.  
  5760.      It will consume less disk space because path information need not to be
  5761.      stored in the information file. 
  5762.  
  5763.      The TBAV utilities will perform faster because they do not have to
  5764.      search through a huge file to locate the information of one specific
  5765.      file.
  5766.  
  5767.      Installation is easier and more reliable in network environments. On
  5768.      networks it is not unusual that the same files have different drive ID's
  5769.      on different workstations. In case of only one information file the
  5770.      drive-ID's should be stored as well, so every workstation should main-
  5771.      tain its own list. The supervisor would easily lose control in this
  5772.      situation.
  5773.  
  5774.  
  5775. 2.2. Format of TbSetup.Dat
  5776.  
  5777.      Editing the TbSetup.Dat file is useful to TBAV site installation (see
  5778.      IV-8). Therefore, some information on the format of this file is neces-
  5779.      sary. The format of the TbSetup.Dat file is very simple. Empty lines, or
  5780.      lines starting with a semi-colon (';') or percent symbol, are either
  5781.      ignored or treated as comment lines. The lines with a preceding percent
  5782.      symbol are also displayed in TbSetup's upper window.
  5783.  
  5784.      Every entry in the TbSetup.Dat file has four items:
  5785.  
  5786.      The filename. The filename must be written in capital letters and
  5787.      without spaces.
  5788.  
  5789.      The length of the file in hexadecimal notation. This field may contain a
  5790.      single asterisk ('*') if an exact filelength match is not required.
  5791.  
  5792.      The file's 32-bit CRC in hexadecimal notation. A single asterisk is
  5793.      allowed if an exact checksum match is not required. 
  5794.  
  5795.  
  5796.  
  5797.                                       IV - 3
  5798. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  5799.  
  5800.  
  5801.      The hexadecimal number representing flags that should be set when the
  5802.      listed file is found on the system.
  5803.  
  5804.      The rest of the line may be used for a brief comment.
  5805.  
  5806.      You may use the following flags:
  5807.  
  5808.      bit 0  (0001)  Do not perform heuristic analysis
  5809.      bit 1: (0002)  Ignore CRC changes (self-modifying file)
  5810.      bit 2: (0004)  Scan for all signatures (lan remote boot file) 
  5811.      bit 3: (0008)  Do not change read-only attribute of this file 
  5812.      bit 4: (0010)  The program stays resident in memory
  5813.      bit 5: (0020)  The program performs direct disk access
  5814.      bit 6: (0040)  Program is allowed to remove read-only attributes
  5815.      bit 15:(8000)  Interrupt rehook required for TbDriver.Exe
  5816.  
  5817.  
  5818.      This is what the entries in TbSetup.Dat look like:
  5819.  
  5820.           ; filename   Length 32-bit CRC  Flags  Comment
  5821.  
  5822.           ; Files that trigger the heuristic alarm of TbScan:
  5823.           4DOS.COM     19FEA         *    0001   ;4Dos 4.0a
  5824.           AFD.COM      0FEFE  4B351A86    0001   ;AFD debugger
  5825.           ARGV0FIX.COM 001D8  431E70C0    0001   ;Argv[0]fix
  5826.           EXE2COM.EXE  00BEA  49276F89    0001   ;Exe to Com conv. utility
  5827.           KILL.EXE     00632  74D41811    0001   ;PcTools 6.0 utility
  5828.           WATCH.COM    003E1  2353625D    0001   ;TSR monitoring utility
  5829.  
  5830.           ; Files that need to be scanned completely, for ALL viruses:
  5831.           NET$DOS.SYS      *         *    0004   ;Disk image Novell boot
  5832.  
  5833.           ; Files without fixed checksum due to internal config area's:
  5834.           Q.EXE            *         *    000A    ;Qedit (all versions)
  5835.           TBCONFIG.COM     *         *    000A    ;all versions
  5836.  
  5837.  
  5838.      Defining new entries
  5839.  
  5840.      If you have any files that should be included in the list, please let us
  5841.      know! We would like to receive a copy to enhance our products and keep
  5842.      TbSetup.Dat up to date. Candidates for inclusion would be any program
  5843.      that triggers the heuristic analysis of TbScan. Whenever you choose
  5844.      'V)alidate program' in the TbScan message window, you will find that on
  5845.      subsequent occasions TbSetup displays the value '0001' in the flags
  5846.      field. If your company has many files like this installed on multiple
  5847.      machines, you may want to include these files in the TbSetup.Dat file
  5848.      yourself. In order to do that execute TbSetup for the file in question
  5849.      and make a note of its filelength and 32-bit CRC, as displayed on the
  5850.      screen. Then edit the TbSetup.Dat file entering the exact filename, the
  5851.      file length and the CRC number, plus the number of any flags you wish to
  5852.  
  5853.  
  5854.                                       IV - 4
  5855. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  5856.  
  5857.  
  5858.      set for that file. If you now use TbSetup on another machine it will set
  5859.      the appropriate flags automatically.
  5860.  
  5861. =>   Note:You may manually set or clear a flag field value when executing
  5862.      TbSetup at the DOS prompt with option 'set' and 'reset' as follows:
  5863.  
  5864.           TBSETUP TEST.EXE SET=0001
  5865.  
  5866.  
  5867. 2.3. TBAV site installation
  5868.  
  5869.      If you have to install the TBAV utilities on a lot of machines in one
  5870.      company, it would be tedious to invoke for instance every single TSR and
  5871.      disk utility on each machine in order to 'teach' TBAV which programs are
  5872.      valid and which are not. Fortunately, this is not necessary. In the
  5873.      present section, three examples are presented on how to simplify instal-
  5874.      lation on several machines.
  5875.  
  5876.      1.   If a resident utility named, for instance, TSRUTIL.EXE is used
  5877.           throughout the company, you can predefine permission by using
  5878.           TbSetup to determine the length and CRC of the program. Now put the
  5879.           name of this program along with the other information in the file
  5880.           TbSetup.Dat and assign the value '0010' to it. 
  5881.  
  5882.      Example:
  5883.           TSRUTIL.EXE  01286  E387AB21  0010  ;Our TSR utility
  5884.  
  5885.  
  5886.      2.   If a disk utility named, for instance, DISKUTIL.EXE is used throug-
  5887.           hout the company, you can predefine permission by using TbSetup to
  5888.           determine the length and CRC of the program. Now put the name of
  5889.           this program along with the other information in the file TbSetup.
  5890.           dat and assign the value '0020' to it.
  5891.  
  5892.      Example:
  5893.           DISKUTIL.EXE  01286  E387AB21  0020  ;Our DISK utility
  5894.  
  5895.      If you now execute TbSetup on every machine (you have to do this anyway)
  5896.      it will recognize this utility and it will set the disk access permissi-
  5897.      on flag for TbMem / TbDisk automatically.
  5898.  
  5899.      3.   If a utility named, for instance, UTIL.EXE is used throughout the
  5900.           company which causes TbScan to give false positives, you can
  5901.           predefine TbSetup to avoid heuristic scanning of the relevant
  5902.           program. Put the name of this program along with the other informa-
  5903.           tion in the file TbSetup.Dat and assign the value '0001' to it.
  5904.  
  5905.  
  5906.  
  5907.  
  5908.  
  5909.  
  5910.  
  5911.                                       IV - 5
  5912. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  5913.  
  5914.  
  5915.      Example:
  5916.           UTIL.EXE  01286  E387AB21  0001  ;Our utility
  5917.  
  5918.      If you now execute TbSetup on every machine (you have to do this anyway)
  5919.      it will recognize this utility and TbScan will not perform heuristic
  5920.      scanning.
  5921.  
  5922.      Also consult the TbSetup.Dat file.
  5923.  
  5924.  
  5925.  
  5926.  
  5927.  
  5928.  
  5929.  
  5930.  
  5931.  
  5932.  
  5933.  
  5934.  
  5935.  
  5936.  
  5937.  
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.  
  5949.  
  5950.  
  5951.  
  5952.  
  5953.  
  5954.  
  5955.  
  5956.  
  5957.  
  5958.  
  5959.  
  5960.  
  5961.  
  5962.  
  5963.  
  5964.  
  5965.  
  5966.  
  5967.  
  5968.                                       IV - 6
  5969. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  5970.  
  5971.  
  5972. 3. TbScan
  5973.  
  5974. 3.1. Heuristic scanning
  5975.  
  5976.      TbScan is not just a signature scanner. It also disassembles the file
  5977.      being processed, for the following purposes:
  5978.  
  5979.      1)   By disassembling the file the scanner can restrict itself to the
  5980.           area of the file where the virus might reside, reducing false
  5981.           alarms and speeding up the process.
  5982.  
  5983.      2)   It makes it possible to use the algorithmic detection method on
  5984.           encrypted viruses whose signatures would otherwise remain invisible
  5985.           to the scanner.
  5986.  
  5987.      3)   And it makes it possible to detect suspicious instruction sequen-
  5988.           ces.
  5989.  
  5990.      The detection of suspicious instruction sequences is named 'heuristic
  5991.      scanning'. It is a very powerful feature that enables you to detect new
  5992.      or modified viruses and to verify the results of the signature scan. You
  5993.      no longer have to rely on the scanner's publisher having the same virus
  5994.      as you might have. In normal cases a scanner can only find a virus if
  5995.      the scanner's publisher did have a sample of that virus, in order to
  5996.      make a suitable signature. With heuristic scanning a signature is no
  5997.      longer required, enabling the scanner to detect yet unknown viruses. You
  5998.      should not underestimate the importance of heuristic scanning, since
  5999.      every month at least 50 new viruses are reported. It is very unlikely
  6000.      that a publisher is the first one to get these new viruses...
  6001.  
  6002.  
  6003.      Heuristic level 1                       Heuristic level 2
  6004.      ------------------------------------------------------------
  6005.      Always enabled                          Only with option 'heuris
  6006.                                              tic' or after a virus has been
  6007.                                              found. 
  6008.      Detects 50% of the unknown viruses.     Detects 90% of the viruses
  6009.      Almost never causes false alarms.       Causes a few false alarms.
  6010.      Displays 'Probably infected'            Displays 'Might be infec
  6011.                                              ted'
  6012.  
  6013.  
  6014.      TEST.EXE <scanning...>         OK  (no flags)
  6015.      TEST.EXE <scanning...> R       OK  (nothing serious)
  6016.      TEST.EXE <scanning...> FRM         might be infected by unknown virus
  6017.      TEST.EXE <scanning...> FRALM#      probably infected by unknown virus  
  6018.  
  6019.      How does heuristic scanning actually work? Every program contains
  6020.      instructions for the PC's processor. By looking into the file's contents
  6021.      and by interpreting the instructions TbScan is able to detect the
  6022.      purpose of these instructions. If the purpose seems to be to format a
  6023.      disk, or to infect a file, TbScan issues a warning. There are a lot of
  6024.  
  6025.                                       IV - 7
  6026. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6027.  
  6028.  
  6029.      instruction sequences which are very common for viruses, but very
  6030.      uncommon for normal programs. Every suspicious instruction sequence is
  6031.      assigned to a character: a heuristic flag. Every heuristic flag denotes
  6032.      a score. If the total score exceeds a predefined limit, TbScan assumes
  6033.      the file contains a virus. 
  6034.  
  6035.      There are actually two predefined limits: the first one is quite sensi-
  6036.      tive and can be reached by some normal innocent programs. If this limit
  6037.      is reached, TbScan highlights the heuristic flags that are displayed on
  6038.      the screen and increases the 'suspected items' counter. TbScan does not
  6039.      indicate the existence of a virus, unless you have specified the 'heu-
  6040.      ristic' option. If you do have specified this option, TbScan tells you
  6041.      the file 'Might be infected by an unknown virus'. 
  6042.  
  6043.      The second heuristic limit will be triggered by a lot of viruses, but
  6044.      not by normal programs. If this limit is reached TbScan tells you that
  6045.      the file is 'Probably infected by an unknown virus.'
  6046.  
  6047. =>   Note: TbScan performs heuristic analysis only nearby the entry-point of
  6048.      a file. Therefore, TbScan does not detect direct writes to disk by some
  6049.      disk utilities nor does TbScan detect some programs as TSR programs.
  6050.      This is just the result of a specific approach to minimize false alarms.
  6051.      In case of a virus, the offending instructions are always nearby the
  6052.      entry-point (except when the virus is over 10Kb in size) so TbScan will
  6053.      detect suspicious phenomenons in these situations anyway. 
  6054.  
  6055.  
  6056. 3.2. Integrity checking
  6057.  
  6058.      TbScan will perform integrity checking while scanning. You have to use
  6059.      TbSetup to generate the Anti-Vir.Dat files. Once these files exist on
  6060.      your system TbScan will check that every file being scanned matches the
  6061.      information maintained in the Anti-Vir.Dat files. If a virus infects a
  6062.      file, the maintained information will not match anymore with the now
  6063.      changed file, and TbScan will inform you about this. There are no
  6064.      (command line) options to enable this feature: TbScan will perform
  6065.      integrity checking automatically if it detects the Anti-Vir.Dat files.
  6066.      Note that TbScan only reports file changes that could indicate a virus.
  6067.      Internal configuration areas of program files may also change, but
  6068.      TbScan does normally not report this. However, if a file gets infected
  6069.      with any virus -known or unknown - the vital information will change and
  6070.      TbScan will indeed report it to you!
  6071.  
  6072.      It is however possible that the checked file changes itself or changes
  6073.      frequently due to another cause. In this case you might want to exclude
  6074.      the program from integrity checking to avoid future false alarms. TbScan
  6075.      will offer you an additional menu option: 'V)alidate program'. For more
  6076.      information about this menu option consult 'Program validation' (page 6
  6077.      of this section).
  6078.  
  6079.  
  6080.  
  6081.  
  6082.                                       IV - 8
  6083. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6084.  
  6085.  
  6086. 3.3. Program validation
  6087.  
  6088.      This chapter only applies if you use TbSetup to generate the Anti-
  6089.      Vir.Dat records. Without these records program validation is not an
  6090.      option.
  6091.  
  6092.      TbScan will perform as intended on most programs. There are some pro-
  6093.      grams, however, that require special attention in order to avoid false
  6094.      alarms. Most of these programs are recognized automatically by the
  6095.      TbSetup program. Nevertheless it is certainly possible your PC contains
  6096.      some program files which trigger the heuristic alarm of TbScan and/or
  6097.      programs files which change frequently.
  6098.  
  6099.      If an 'infection' has been found with the heuristic analysis or integri-
  6100.      ty checking only and if there is an Anti-Vir.Dat record available,
  6101.      TbScan offers an additional option in its virus-alert window:  
  6102.  
  6103.           'V)alidate program'
  6104.  
  6105.      If you are convinced that the indicated program does not contain a
  6106.      virus, you can press 'V' to set a flag in the program's record. This
  6107.      makes it possible to avoid future false alarms.
  6108.  
  6109.      There are two validation modes. If TbScan alarms you due to a file
  6110.      change, the validation applies to future file changes only. If the alarm
  6111.      is due to heuristic analysis, the validation only applies to heuristic
  6112.      results. If the file is excluded from heuristic analysis the file will
  6113.      still be checksummed.  If the file is excluded from integrity checking
  6114.      TbScan will still perform heuristic analysis on the file.
  6115.  
  6116. =>   Note: if you replaced a file (software upgrade) and you did not use
  6117.      TbSetup, TbScan will pop-up its virus alert window to inform you about
  6118.      the file change. Do not select the validation option in this case,
  6119.      because this would exclude the file for future integrity checking. You
  6120.      should abort TbScan and execute TbSetup on the changed file(s) instead.
  6121.  
  6122.  
  6123. 3.4. The algorithms
  6124.  
  6125.      When TbScan processes a file it will display either 'Looking', 'Chec-
  6126.      king', 'Tracing', 'Scanning' or 'Skipping'.
  6127.  
  6128.      Looking
  6129.  
  6130.      With 'Looking' TbScan indicates it has successfully located the entry
  6131.      point of the program in one step. The program code has been identified
  6132.      so TbScan knows where to search without the need of additional analysis.
  6133.      'Looking' will be used on most known software.
  6134.  
  6135.  
  6136.  
  6137.  
  6138.  
  6139.                                       IV - 9
  6140. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6141.  
  6142.  
  6143.      Checking
  6144.  
  6145.      'Checking' indicates TbScan has successfully located the entry point of
  6146.      the program, and is scanning a frame of about 4Kb around the entry
  6147.      point. If the file is infected, the virus' signature will be located in
  6148.      this area. 'Checking' is a very fast and reliable scan algorithm.
  6149.      Checking will be used on most unknown software.
  6150.  
  6151.      Tracing
  6152.  
  6153.      'Tracing' means that TbScan has successfully traced a chain of jumps or
  6154.      calls while locating the entry-point of the program, and is scanning a
  6155.      frame of about 4Kb around this location. If the file has been infected,
  6156.      the signature of the virus will be located in this area. 'Tracing' is a
  6157.      fast and reliable scan algorithm. Tracing will be primarily used for
  6158.      TSR-type COM files or Turbo Pascal-compiled programs. Most viruses will
  6159.      force TbScan to use 'Tracing'.
  6160.  
  6161.      Scanning
  6162.  
  6163.      TbScan is scanning the entire file (except for the exe-header which
  6164.      cannot contain any viral code). This algorithm will be used if 'Look-
  6165.      ing', 'Checking' or 'Tracing' can't be used safely. This is the case
  6166.      when the entry-point of the program contains other jumps and calls to
  6167.      code located outside the scanning frame, or when the heuristic analyzer
  6168.      found something that should be investigated more thoroughly. 'Scanning'
  6169.      is a slow algorithm. Since it processes almost the entire file, inclu-
  6170.      ding data areas, false alarms are more likely to occur. The 'Scanning'
  6171.      algorithm will be used while scanning bootsectors, SYS and BIN files.
  6172.  
  6173.      Skipping
  6174.  
  6175.      'Skipping' will occur with SYS and OVL files only. It simply means that
  6176.      the file will not be scanned. As there are many SYS files containing no
  6177.      code at all (like CONFIG.SYS), it makes absolutely no sense to scan
  6178.      these files for viruses. The same applies to .OV? files. Many overlay
  6179.      files do not deserve to be called as such as they lack an exe-header.
  6180.      Such files cannot be invoked through DOS, which makes them just as
  6181.      invulnerable to direct virus attacks as .TXT files are. If a virus is
  6182.      reported to have infected an .OV? file, it involved one of the relative-
  6183.      ly few overlay files which do contain an exe-header. In that case the
  6184.      infection was the result of the virus monitoring the DOS exec-call
  6185.      (function 4Bh) and infecting any program being invoked that way, inclu-
  6186.      ding 'real' overlay files.
  6187.  
  6188.  
  6189. 3.5. The TbScan.Lng file
  6190.  
  6191.      The TbScan.Lng file contains all texts being displayed by TbScan. You
  6192.      can translate or customize the messages with any ASCII editor.
  6193.  
  6194.  
  6195.  
  6196.                                       IV - 10
  6197. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6198.  
  6199.  
  6200.      The messages are separated by the dollar sign ($). The first message
  6201.      displays our address and registration info. You can edit this message as
  6202.      you please, for instance adding your company logo.
  6203.  
  6204.      You may add color codes to the TbScan.Lng file. A color code is precee-
  6205.      ded by the character '|'. The following color codes are available: (all
  6206.      numbers are in hex).
  6207.  
  6208.      Color      Foreground Highlight   Background
  6209.  
  6210.      Black      00         08          00
  6211.      Blue       01         09          10
  6212.      Green      02         0A          20
  6213.      Cyan       03         0B          30
  6214.      Red        04         0C          40
  6215.      Magenta    05         0D          50
  6216.      Yellow/Brown06        0E          60
  6217.      White/gray 07         0F          70
  6218.  
  6219.  
  6220.      Example:  To make a highligted green character on a red background the
  6221.                color code would be 0A+40=4A.To make the character blink add
  6222.                80h to the result.
  6223.  
  6224.  
  6225.  
  6226.  
  6227.  
  6228.  
  6229.  
  6230.  
  6231.  
  6232.  
  6233.  
  6234.  
  6235.  
  6236.  
  6237.  
  6238.  
  6239.  
  6240.  
  6241.  
  6242.  
  6243.  
  6244.  
  6245.  
  6246.  
  6247.  
  6248.  
  6249.  
  6250.  
  6251.  
  6252.  
  6253.                                       IV - 11
  6254. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6255.  
  6256.  
  6257. 4. TbClean
  6258.  
  6259.      In order to understand the way a cleaning program operates, try to
  6260.      imagine how a virus usually goes about infecting a program. The basic
  6261.      principle is not difficult. A virus - just another program really - adds
  6262.      itself to the end of the program it is going to infect. The additional
  6263.      viral code, naturally, increases the size of the program. But simply
  6264.      appending a viral program to another program is not enough, to do any
  6265.      real harm - the viral code has to be executed first. So, the virus grabs
  6266.      the first few bytes at the start of the program, and replaces them with
  6267.      a 'jump' instruction to its own viral code. That way the virus is able
  6268.      to take control as soon as the program is started. Chances are you will
  6269.      never even notice the momentary delay while the extra code is executed,
  6270.      doing whatever the virus has been programmed to do. The virus then
  6271.      restores the original instructions and restarts the program (jump to the
  6272.      start). Your program, more often than not, works as usual - and it goes
  6273.      without saying that any virus worth its salt will make sure it isn't
  6274.      going to draw undue attention too soon! 
  6275.  
  6276.      So, in order to purge a program, we must first restore the starting
  6277.      instruction bytes, which the virus replaced with the jump to its own
  6278.      code. The virus is going to need these bytes again later on, so they
  6279.      will be stored somewhere in the viral code. The cleaner starts out to
  6280.      find those bytes, puts them back in their old place, and truncates the
  6281.      file to the original size.
  6282.  
  6283.      Cleaner programs basically come in two types - the conventional type,
  6284.      for specific types of viruses, and the far more advanced generic clea-
  6285.      ner, offering a much wider scope. Let's take a closer look at both
  6286.      cleaner types and find out where they differ.
  6287.  
  6288.  
  6289.      Conventional cleaners
  6290.  
  6291.      A conventional cleaner has to know which virus to remove. Suppose your
  6292.      system is infected with a Jerusalem/PLO virus. When you start such a
  6293.      conventional cleaner, a procedure much like the following will take
  6294.      place:
  6295.  
  6296.  
  6297.  
  6298.  
  6299.  
  6300.  
  6301.  
  6302.  
  6303.  
  6304.  
  6305.  
  6306.  
  6307.  
  6308.  
  6309.  
  6310.                                       IV - 12
  6311. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6312.  
  6313.  
  6314.          original program        infected program
  6315.  
  6316.          +--------------+        +--------------+
  6317.          |              |        |              |
  6318.          | p            |  100:  |jump          |
  6319.          | r            |        |to 2487       |
  6320.          | o            |        | o            |
  6321.          | g            |        | g            |
  6322.          | r            |        | r            |
  6323.          | a            |        | a            |
  6324.          | m            |        | m            |
  6325.          |              |        |              |
  6326.          | c            |        | c            |
  6327.          | o            |        | o            |
  6328.          | d            |        | d            |
  6329.          | e            |        | e            |
  6330.          |              |        |              |
  6331.          +--------------+        +--------------+
  6332.                            2487: |              |
  6333.                                  |  VIRUS!    p |
  6334.                                  |            r |
  6335.                                  |jmp 100       |
  6336.                                  +--------------+
  6337.  
  6338.  
  6339.      The conventional cleaner: 'Hey, the signature file tells me this file is
  6340.      infected with the Jerusalem/PLO virus. Ok, let's see, this virus tacks
  6341.      on 1783 bytes at the end, and it overwrites the first three bytes of the
  6342.      original program with a jump to itself. The original bytes are located
  6343.      at offset 483 in the viral code. So, I have to take those bytes, copy
  6344.      them to the beginning of the file, and I have to remove 1873 bytes of
  6345.      the file. That's it!'
  6346.  
  6347.      There are several pitfalls to worry about in a scenario like this.
  6348.      Obviously, the cleaner has to be given some means to recognize the virus
  6349.      it is supposed to remove. A conventional cleaner cannot cope with a
  6350.      virus unless it knows what to look for. It is even more important to
  6351.      establish the fact that the virus is exactly the same one that the
  6352.      cleaner knows about after checking the validation data. Imagine what
  6353.      whould happen if the virus used in the example had been modified and is
  6354.      now 1869 bytes in size instead of 1873... The cleaner would remove too
  6355.      much! This is not an exceptional case, certainly not after the unslaught
  6356.      of countless so-called mutant straints. The Jerusalem/PLO family, to
  6357.      name but one example, now has more than 100 mutant members!
  6358.  
  6359.  
  6360.      Generic cleaners
  6361.  
  6362.      A generic cleaner works on the principle that any kind of virus -
  6363.      whether or not it has made the signature 'charts' - is bad news. That's
  6364.      why TbClean works with a completely different disinfection scheme that
  6365.      is effective with almost all viruses - it does not even need to recogni-
  6366.  
  6367.                                       IV - 13
  6368. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6369.  
  6370.  
  6371.      ze them. Actually, TbClean represents two cleaners in one: a 'repair'
  6372.      cleaner and a 'heuristic' cleaner.
  6373.  
  6374.      Repair cleaning
  6375.  
  6376.      Repair cleaning needs an Anti-Vir.Dat file that was generated by TbSetup
  6377.      before the infection occurred. The Anti-Vir.Dat file stores vital
  6378.      information about programs, including their original size, the first few
  6379.      instruction codes and a cryptographic checksum. This information is
  6380.      usually all it takes to disinfect a file, no matter what virus, known or
  6381.      unknown, caused the infection. The cleaner will simply restore the bytes
  6382.      at the beginning of the program, truncate the file to the original size,
  6383.      and verify the result by way of the original checksum.
  6384.  
  6385.  
  6386.      Heuristic cleaning
  6387.  
  6388.      TbClean is the first cleaner in the world that has a heuristic cleaning
  6389.      mode. This mode does not need any information about viruses either, but
  6390.      it has the added advantage that it doesn't even care about the original,
  6391.      uninfected state of a program. This cleaning mode is very effective if
  6392.      your system is infected with an unknown virus and you neglected to let
  6393.      TbSetup generate the Anti-Vir.Dat files in time.
  6394.  
  6395.      In heuristic mode, TbClean loads the infected file and starts emulating
  6396.      the program code. It uses a combination of disassembly, emulation and,
  6397.      sometimes, execution to trace the flow of the viral code, pretending to
  6398.      do more or less exactly what the virus would normally be doing. When the
  6399.      virus gets to the original program's instructions and jumps back to the
  6400.      original program code, TbClean stops the emulation process, with a
  6401.      'thank you' to the virus for its cooperation in restoring the original
  6402.      bytes. 
  6403.  
  6404.      The actual cleaning process involves almost the same three steps as with
  6405.      repair cleaning. First the program startup code is repaired and copied
  6406.      back to the file. Then the viral code, now rendered useless and ineffec-
  6407.      tive, is removed and, for the sake of security, TbClean will do a final
  6408.      analysis of the purged program file.
  6409.  
  6410.  
  6411.  
  6412.  
  6413.  
  6414.  
  6415.  
  6416.  
  6417.  
  6418.  
  6419.  
  6420.  
  6421.  
  6422.  
  6423.  
  6424.                                       IV - 14
  6425. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6426.  
  6427.  
  6428. 5. TbGensig
  6429.  
  6430. 5.1 The Purpose of TbGenSig
  6431.  
  6432.      TbGenSig is a signature file compiler. Since TBAV is distributed with an
  6433.      up to date, ready-to-use signature file, you do not really need the
  6434.      signature file compiler.
  6435.  
  6436.      If, however, you want to define your own virus signatures, you will need
  6437.      the TbGensig utility. You can use either published signatures or define
  6438.      your own ones if you are familiar with the structure of software.
  6439.  
  6440.      One way or another, you only need to do this in case of an emergency,
  6441.      like in case of the unfortunate event that your machine or even your
  6442.      company is attacked by a yet unknown, thus not recognized virus. It is
  6443.      recommended to send a few samples of the virus to some virus experts
  6444.      anyway, in order to let scanners recognize the virus in the next upgra-
  6445.      de.
  6446.  
  6447.      Since it is not possible to explain the whole subject of virus hunting
  6448.      in one manual, this document assumes you have enough experience and
  6449.      knowledge to make your own signatures.
  6450.  
  6451.      TbGenSig searches for a file named UserSig.Dat in the current directory.
  6452.      This file should contain the signatures you want to add to the TBAV
  6453.      signature file TbScan.Sig. TbGenSig checks the contents of the User-
  6454.      Sig.Dat file and applies it to the TbScan.Sig file.
  6455.  
  6456.      If you want to delete or modify your signatures, just edit or delete the
  6457.      UserSig.Dat file and execute TbGenSig again.
  6458.  
  6459.      TbGenSig will list all signatures in the TbScan.Sig file on screen while
  6460.      being executed.
  6461.  
  6462.  
  6463. 5.2 Defining signatures
  6464.  
  6465.      Format of the  UserSig.dat text
  6466.  
  6467.      You can create and edit the UserSig.Dat file with every DOS editor which
  6468.      is able to output unformatted text. All lines starting with ';' are
  6469.      comment lines. TbGenSig file ignores these lines.
  6470.  
  6471.      Lines starting with '%' will be displayed in the upper TbGenSig window.
  6472.  
  6473.      In the first line the name of a virus is expected. The second line
  6474.      contains one or more keywords. The third line contains the signature
  6475.      itself. This combination of three lines is called a 'signature record'.
  6476.  
  6477.  
  6478.  
  6479.  
  6480.  
  6481.                                       IV - 15
  6482. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6483.  
  6484.  
  6485.      A signature record should look like this:
  6486.  
  6487.           Test virus
  6488.           exe com inf
  6489.           abcd21436587abcd
  6490.  
  6491.      You may use spaces in the signature for your own convenience. TbGenSig
  6492.      will ignore these spaces.
  6493.  
  6494.  
  6495.      Adding a published signature    
  6496.  
  6497.      If you want to add a signature that has been published, you should act
  6498.      as illustrated below.
  6499.  
  6500.      -    Edit or create the UserSig.Dat file. Convert the published signatu-
  6501.           re to an acceptable format for TbGenSig.
  6502.  
  6503.      -    Use keywords COM EXE BOOT INF
  6504.  
  6505.           You would get:
  6506.  
  6507.           New virus
  6508.           exe com boot inf
  6509.           1234abcd5678efab
  6510.  
  6511.      -    Execute TbGenSig.
  6512.  
  6513.  
  6514.      Defining a Signature with TBScan
  6515.  
  6516.      This section is intended for advanced users who own a TBAV.KEY file.
  6517.  
  6518.      Although the TbScan.Sig file is updated frequently, new viruses are
  6519.      created every day, outpacing the regular upgrading service of this data
  6520.      file. It is therefore possible that one day your system gets infected by
  6521.      a recently created virus that has not yet been listed in the signature
  6522.      file. TbScan will not always detect the virus in such cases, not even
  6523.      with the heuristic analysis. If you are convinced that your system must
  6524.      have been infected without TbScan confirming this, thischapter will
  6525.      supply you with a valuable tool to detect unknown viruses with. This
  6526.      section offers step-by-step assistance in creating an emergency signatu-
  6527.      re that can be (temporarily) added to your copy of TbScan.Sig
  6528.  
  6529.      -    Collect some infected files and copy them into a temporary directo-
  6530.           ry.
  6531.  
  6532.      -    Boot from a clean write-protected diskette. Do NOT execute ANY
  6533.           program from the infected system, even though you expect this
  6534.           program to be clean.
  6535.  
  6536.  
  6537.  
  6538.                                       IV - 16
  6539. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6540.  
  6541.  
  6542.      -    Execute TbScan from your write-protected TbScan diskette with the
  6543.           'extract' option set. Make sure that the temporary directory where
  6544.           you stored the infected files will be TbScan's target directory.
  6545.           With its 'extract' option set, TbScan will NOT scan the files but,
  6546.           instead, display the first instructions that are found at the
  6547.           entry-point of the infected programs. 
  6548.  
  6549.  
  6550. =>   Please note that we highly recommend you to simultaneously set the 'log'
  6551.      option of TbScan to generate a log file.
  6552.  
  6553.      -    Compare the 'signatures' extracted by TbScan. You should see
  6554.           something like this:
  6555.  
  6556.  
  6557.           NOVIRUS1.COM    2E67BCDEAB129090909090ABCD123490CD
  6558.           NOVIRUS2.COM    N/A
  6559.           VIRUS1.COM      1234ABCD5678EFAB909090ABCD123478FF
  6560.           VIRUS2.COM      1234ABCD5678EFAB901234ABCD123478FF
  6561.           VIRUS3.COM      1234ABCD5678EFAB9A5678ABCD123478FF
  6562.  
  6563.      If the 'signatures' are completely different, the files are either
  6564.      probably not infected, or they have been infected by a polymorphic virus
  6565.      that requires an algorithmic detection module to detect it.
  6566.  
  6567.      -    There might be some differences in the 'signatures'. You can use
  6568.           the question mark wildcard ('?') in this case.
  6569.  
  6570.      A signature to detect the 'virus' in the example above could be:
  6571.  
  6572.           1234ABCD5678EFAB ?3 ABCD123478FF
  6573.  
  6574.      The '?3' means that there are three bytes on that position that should
  6575.      be skipped.
  6576.  
  6577.      -    Add the signature to the data file UserSig.Dat. Give the virus a
  6578.           name in the first line of its entry. Specify the following key-
  6579.           words: COM, EXE, INF, ATE in the second line. Enter the signature
  6580.           in the third.
  6581.  
  6582.  
  6583.      You would get:
  6584.  
  6585.           New virus
  6586.           exe com ate inf
  6587.           1234abcd5678efab?3abcd123478ff
  6588.  
  6589.  
  6590.      -    Execute TbGenSig. Make sure the resulting TbScan.Sig file is in the
  6591.           TbScan directory.
  6592.  
  6593.  
  6594.  
  6595.                                       IV - 17
  6596. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6597.  
  6598.  
  6599.      -    Execute TbScan again in the directory containing the infected
  6600.           files. TbScan should now detect the virus.
  6601.  
  6602.      -    Send a couple of infected files to a recommended virus expert,
  6603.           preferably to the ThunderBYTE organisation.
  6604.  
  6605.      Congratulations! You have defined a signature all by yourself! Now you
  6606.      can scan all your machines in search of the new virus.
  6607.      However, keep in mind that this method of extracting a signature is a
  6608.      'quick-and-dirty' solution to viral problems. The extracted signature
  6609.      might not detect the presence of the virus in all cases. A signature
  6610.      that is guaranteed to detect all instances of the virus can be made only
  6611.      after complete disassembly of the new virus. For these reasons you
  6612.      should NOT distribute your home-made 'signature' to others. The signatu-
  6613.      re eventually assembled by experienced anti-virus researchers will be
  6614.      completely different in most cases!
  6615.  
  6616.  
  6617. 5.3 Keywords
  6618.  
  6619.      Keywords are used for several purposes. They are classified in catego-
  6620.      ries. Keywords may be separated by spaces, commas or tabs. The maximum
  6621.      line length is 80 characters.
  6622.  
  6623.      At least one of the following flags should be specified:
  6624.      BOOT, COM, EXE, HIGH, LOW, SYS or WIN.
  6625.  
  6626.  
  6627.      Item keywords
  6628.  
  6629.  
  6630.      BOOT       Signature can be found in bootsector/partition
  6631.      COM        Signature can be found in COM programs.                  
  6632.  
  6633.      This flag initiates the scanner to search for this signature in executa-
  6634.      ble files that do not have an EXE header or device header.
  6635. =>   Note:   The file contents determines the file type, not the filename
  6636.      extension!
  6637.  
  6638.  
  6639.      EXE        Signature can be found in EXE programs.
  6640.  
  6641.      This flag initiates the scanner to search for this signature in the load
  6642.      module of EXE type files. EXE files are files that have an EXE header.
  6643. =>   Note: The file contents determines the file type, not the filename
  6644.      extension!
  6645.  
  6646.  
  6647.      HIGH      Signature can be found in HIGH memory (above program).This
  6648.                flag initiates the scanner to search for this signature in
  6649.                memory above the memory allocated by the scanner.
  6650.  
  6651.  
  6652.                                       IV - 18
  6653. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6654.  
  6655.  
  6656.      This keyword is intended for resident viruses that allocate memory at
  6657.      system boot, or viruses that decrease the size of the last MCB (Memory
  6658.      Control Block).
  6659. =>   Note:  The flag HIGH does not mean that the signature should be searched
  6660.      in UPPER memory.
  6661.  
  6662.  
  6663.      LOW       Signature can be found in LOW memory. This flag initiates the
  6664.                scanner to search for this signature in memory below the PSP
  6665.                (Program Segment Prefix) of the scanner and in the UMB (Upper
  6666.                Memory Blocks). This keyword is intended for viruses that
  6667.                remain resident in memory, using the normal DOS TSR (Terminate
  6668.                and Stay Resident) function calls. 
  6669.  
  6670.  
  6671.      SYS       Signature can be found in SYS programs.
  6672.  
  6673.  
  6674.      WIN       Signature can be found in Windows programs.
  6675.  
  6676.  
  6677.      Message keywords
  6678.  
  6679.      DAM        Message prefix:  'damaged by'.
  6680.      DROP       Message prefix:  'dropper of'.
  6681.      FND        Message prefix:  'found the'.
  6682.      INF        Message prefix:  'infected by' 
  6683.                 Message suffix:  'virus'
  6684.      JOKE       Message prefix:  'joke named'.
  6685.      OVW        Message prefix:  'overwritten by'.
  6686.      PROB       Mess. pre-prefix:'probably'.
  6687.      TROJ       Message prefix:  'trojanized by'.
  6688.  
  6689.  
  6690.  
  6691.      Position keywords
  6692.  
  6693.  
  6694.      UATE      Signature should be found at unresolved entry-point.
  6695.  
  6696.      Purpose:
  6697.      The signature starts directly at the unresolved entry-point of the viral
  6698.      code. With some polymorphic viruses, it may be possible to create a
  6699.      signature from the degarbling routine, although it may either be too
  6700.      short or give false positives with a global search. An initial branch
  6701.      instruction  may be part of the signature.
  6702.  
  6703.                 COM type files:  top of file (IP 0100h).
  6704.                 EXE type files:  CS:IP as defined in the
  6705.                                  EXE-header.
  6706.                 WIN type files:  Non-DOS CS:IP of the new
  6707.                                  EXE-header.
  6708.  
  6709.                                       IV - 19
  6710. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6711.  
  6712.  
  6713.      Remarks:
  6714.      The keyword UATE is not allowed for BOOT, SYS, LOW, HMA or HIGH type
  6715.      signatures.
  6716.  
  6717.  
  6718.      ATE        Signature should be found AT ENTRY point.
  6719.  
  6720.      Purpose:
  6721.      The signature starts directly at the entry-point of the viral code. With
  6722.      some polymorphic viruses, it may be possible to create a signature from
  6723.      the degarbling routine, although it may either be too short or give
  6724.      false positives with a global search.
  6725.  
  6726.      Therefore the keyword ATE is used to make sure that the scanners do not
  6727.      scan the entire file for the signature, but only look at the entry-point
  6728.      for the signature.
  6729.  
  6730.      The entry-point of a virus is defined by the first byte that is not
  6731.      equal to either a JUMP SHORT, JUMP LONG or a CALL NEAR.
  6732.  
  6733.                 Unresolved entry point:1JUMP LONG   3
  6734.                                      2 ...
  6735.                                      3 JUMP SHORT   5
  6736.                                      4 ...
  6737.                                      5 CALL FAR     7
  6738.                                      6 ...
  6739.                                      7 CALL NEAR    9
  6740.                                      8 ...
  6741.                 Resolved entry point:9  POP <reg>
  6742.  
  6743.           The entry-point of the above fragment is Line 9 as this is the
  6744.           first code to be executed which is not a JUMP SHORT, JUMP LONG or
  6745.           CALL  NEAR or CALL FAR.
  6746.  
  6747.      Remarks:
  6748.      1)   The entry-point can be determined by a code analyzer to cope with
  6749.           tricks like coding a NOP or DEC just before the branch instruction.
  6750.           Therefore the results of the scanner should be tested carefully. In
  6751.           case of trouble use the TbScan 'extract' option to find out what
  6752.           TbScan considers to be the entry point of the program. 
  6753.  
  6754.      2)   The flag ATE is not allowed for BOOT, SYS, LOW, HMA or HIGH type
  6755.           signatures.
  6756.  
  6757.  
  6758.      XHD       Signature can be found at offset 2 of the EXE header.
  6759.  
  6760.      Purpose:
  6761.      This position keyword is rarely used. It should only be used to detect
  6762.      the also very rare high-level language viruses; viruses written in a
  6763.      language like C or Basic. These viruses normally contain standard setup
  6764.      routines and library routines which are not suitable to define a signa-
  6765.  
  6766.                                       IV - 20
  6767. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6768.  
  6769.  
  6770.      ture. The XHD keyword can be used as a last resort to detect such
  6771.      viruses.
  6772.  
  6773.      Remarks:
  6774.      This flag may only be used for EXE or WIN type signatures.
  6775.  
  6776.  
  6777. 5.4 Wildcards
  6778.  
  6779.      In a virus signature, wildcards characters may be used to recognize so
  6780.      called polymorphic (self- modifying/mutating) virus code. Below a
  6781.      description is presented of the wildcard notation. All numbers are in
  6782.      hexadecimal.
  6783.  
  6784.  
  6785.      Position Wildcards
  6786.  
  6787.      Position wildcards affect the position where the parts of the signature
  6788.      will be matched.
  6789.  
  6790.           Skip
  6791.           ?n         =  Skip n amount of bytes and continue.
  6792.           ?@nn       =  Skip nn amount of bytes and continue.
  6793.                          nn should not exceed 7F.
  6794.  
  6795.           Variable
  6796.           *n         =  Skip up to n bytes.
  6797.           *@nn       =  Skip up to nn bytes and continue.
  6798.                          nn should not exceed 1F.
  6799.  
  6800.  
  6801.      Opcode wildcards      
  6802.  
  6803.      The 'opcode' wildcards are shaped to detect instruction ranges:
  6804.  
  6805.           Low opcode
  6806.           nL         =  One of the values in the range n0-n7.
  6807.  
  6808.           High opcode
  6809.           nH         =  One of the values in the range n8-nF.
  6810.  
  6811.  
  6812.      Intended use of the opcode wildcards:
  6813.  
  6814.      Suppose a polymorphic virus puts a value in a word register (using a MOV
  6815.      WREG,VALUE instruction), and increments a register (using an INC WREG
  6816.      instruction, and pops a word register from the stack (using a POP
  6817.      instruction). Both the registers and the value are variable. 
  6818.  
  6819.      You could code it like this:
  6820.           bh4l5h
  6821.  
  6822.  
  6823.                                       IV - 21
  6824. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6825.  
  6826.  
  6827.      B8-BF are the opcodes for 'MOV WREG,VALUE', 40-47 are the opcodes for
  6828.      'INC WREG', and 58-5F are the opcodes for 'POP REG'.
  6829.  
  6830.  
  6831.      Example
  6832.  
  6833.      To show the power of the use of the appropriate keywords and wildcards
  6834.      here is the signature of the Haifa.Mozkin virus. This virus is highly
  6835.      polymorphic and encrypted. It contains a small variable decryptor to
  6836.      decrypt the virus.
  6837.  
  6838.      There are two problems here: most bytes are encrypted or variable, thus
  6839.      not suitable to be part of a signature, and the remainder is short and
  6840.      would cause dozens of false alarms.
  6841.  
  6842.      However, using the appropriate keywords and wildcards, it is possible to
  6843.      define a reliable signature. The signature below is used by TbScan to
  6844.      detect the Haifa.Mozkin virus.
  6845.  
  6846.           Haifa.Mozkin
  6847.           com exe ate inf
  6848.           bh?2bh?109?2*22e80?24l4h75fl
  6849.  
  6850.  
  6851.      Let's analyze it.
  6852.  
  6853.      The first line describes the name of the virus. The second line tells
  6854.      the scanner to search for this signature in COM and EXE type files. It
  6855.      also tells the scanner that it should report the file as infected if the
  6856.      signature can be matched. The keyword ATE instructs the scanner to match
  6857.      this signature only at the resolved entry-point of the file. The virus
  6858.      starts of course with decrypting itself, so it is guaranteed that the
  6859.      scanner will scan this location. The ATE instruction limits the scope of
  6860.      this signature to just one position in a file, so this will reduce the
  6861.      chances of false alarms significantly.
  6862.  
  6863.  
  6864.      The third line is the signature definition. Let's reverse engineer it:
  6865.  
  6866.      bh?2      This means: a byte in the range B8-BF followed by two variable
  6867.                bytes. B8-BF is a 'MOV WREG,VALUE' instruction. From the
  6868.                register we only know it is a word register, the value is
  6869.                unknown as well.
  6870.  
  6871.      bh?109    This means: another 'MOV WREG,VALUE' instruction. The register
  6872.                is a word register, and from the value we know that it is in
  6873.                the range 0900 to 09FF.
  6874.  
  6875.      ?2*2      This means: skip two to four bytes. This instruction is inser-
  6876.                ted by the virus to make it harder to define a signature.
  6877.  
  6878.  
  6879.  
  6880.                                       IV - 22
  6881. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                SECTION IV
  6882.  
  6883.  
  6884.      2e80?2    This means: the virus performs an arithmethic byte sized
  6885.                operation with an immediate value (decrypts one byte) with a
  6886.                CS: segment override. The exact operation, the memory location
  6887.                and the value are unknown.
  6888.  
  6889.      4l        This means: a byte in the range 40-47. This is an 'INC WREG'
  6890.                instruction. The virus increments the counter to the next byte
  6891.                to be decrypted.
  6892.  
  6893.      4h        This means: a byte in the range 48-4F. This is a 'DEC WREG'
  6894.                instruction. The virus decrements the iteration count.
  6895.  
  6896.      75fl      Opcode 75 is a JNZ instruction. If the decremented register
  6897.                did not reach zero, the virus jumps back and repeats the
  6898.                operation. How much does it jump? That tells the 'fl' part:
  6899.                somewhere between -16 (F0h) to -8 (F7h) bytes.
  6900.  
  6901.  
  6902.      Although the signature language of TbGenSig is very powerful, there are
  6903.      viruses which are so highly polymorphic that they require even more
  6904.      sophisticated wildcards, keywords or even special detection algorithms.
  6905.      The explanation however of these wildcards, keywords or algorithmic
  6906.      detection definitions is so complicated that it is not suitable to be
  6907.      presented in a user manual.
  6908.  
  6909.  
  6910.  
  6911.  
  6912.  
  6913.  
  6914.  
  6915.  
  6916.  
  6917.  
  6918.  
  6919.  
  6920.  
  6921.  
  6922.  
  6923.  
  6924.  
  6925.  
  6926.  
  6927.  
  6928.  
  6929.  
  6930.  
  6931.  
  6932.  
  6933.  
  6934.  
  6935.  
  6936.  
  6937.                                       IV - 23
  6938. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX A
  6939.  
  6940.  
  6941. APPENDIX A. TBAV messages
  6942.  
  6943.  
  6944.      The TBAV utilities may display various messages when executed. Most
  6945.      messages will be clear enough, but here is some additional information
  6946.      followed by the name of the appropriate TBAV utility.
  6947.  
  6948.  
  6949.      
  6950. TbClean
  6951.  
  6952.  
  6953.      Anti-Vir.Dat record          The Anti-Vir.Dat record has been found, but
  6954.      found: information mat-      the information matches the current state
  6955.      ches the current state       of the file. The Anti-Vir.Dat record was
  6956.      of the file. Anti-           created after the file got infected, or the
  6957.      Vir.Dat file was created     file is not changed at all. TbClean is
  6958.      after the infection.         going to emulate the file to clean it heu-
  6959.      Trying emulation...          ristically.
  6960.  
  6961.      Anti-Vir.Dat record          The Anti-Vir.Dat record that belongs to the
  6962.      found: reconstructing        infected file has been found. The informa-
  6963.      original state...            tion will be used to reconstruct the file.
  6964.  
  6965.      Anti-Vir.Dat record not      The Anti-Vir.Dat file did not exist or did
  6966.      found: original state        not contain information of the infected
  6967.      unknown. Trying emulati-     program, so the original state of the in-
  6968.      on...                        fected program is unknown to TbClean. Tb-
  6969.                                   Clean will switch to its heuristic mode to
  6970.                                   determine the state of the original file.
  6971.  
  6972.                                   Note: to prevent a situation like this,
  6973.                                   make sure to use the TbSetup program to
  6974.                                   generate the Anti-Vir.Dat records.
  6975.  
  6976.                                   These records are of great help to TbClean.
  6977.                                   When the file is already infected it is too
  6978.                                   late to generate the Anti-Vir.Dat records.
  6979.  
  6980.      Emulation terminate:         The emulation process has been terminated
  6981.      <reason>                     for the reason specified. TbClan will now
  6982.      <reason> can be one of       consult the collected information to see if
  6983.      the following:               it can disinfect the file.
  6984.  
  6985.      Jump to BIOS code.           The virus tried to perform a call or jump
  6986.                                   directly into BIOS code. This process can
  6987.                                   not be emulated so it will be aborted. The
  6988.                                   program can probably not be disinfected.
  6989.  
  6990.      Approached stack crash.      The emulated program is approaching a
  6991.                                   crash. Something went wrong while emulating
  6992.                                   the program so it will be aborted. The
  6993.                                   program can probably not be disinfected.
  6994. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX A
  6995.  
  6996.  
  6997.      Attempt to violate li-       TbClean will not disassemble this program
  6998.      cense agreements.            for obvious reasons.
  6999.  
  7000.      Encountered keyboard         The emulated program tries to read the
  7001.      input request.               keyboard. This is very unusual for viruses,
  7002.                                   so the file is probably not infected at
  7003.                                   all.
  7004.  
  7005.      Encountered an invalid       The emulator encountered an unknown in-
  7006.      instruction.                 struction. For some reason the emulation
  7007.                                   failed. The program can probably not be
  7008.                                   disinfected.
  7009.  
  7010.      DOS program-terminate        The emulated program requests DOS to stop
  7011.      request.                     execution. The program is not infected at
  7012.                                   all, or infected by an overwriting virus
  7013.                                   that does not pass control to its host
  7014.                                   program. The program can not be disinfec-
  7015.                                   ted.
  7016.  
  7017.      Jumped to original pro-      The program jumped back to the start po-
  7018.      gram entry point.            sition. It is very likely it is infected.
  7019.                                   The program can probably be disinfected.
  7020.  
  7021.      Undocumented DOS call        This is very common for viruses that add
  7022.      with pointers to reloca-     themselves in front of the COM type pro-
  7023.      ted code.                    gram. The program can probably be disin-
  7024.                                   fected.
  7025.  
  7026.      Encountered an endless       TbClean encountered a situation in which
  7027.      loop.                        the program is executing the same in-
  7028.                                   struction sequences over and over again for
  7029.                                   hundreds of thousands of times. It is unli-
  7030.                                   kely that the program will ever escape from
  7031.                                   this loop, so the emulation will be abor-
  7032.                                   ted.
  7033.  
  7034.      Ctrl-break pressed.          The user pressed <Ctrl><Break> so the clean
  7035.                                   attempt is aborted.
  7036.  
  7037.      Emulation aborted for        If this message is shown, please send a
  7038.      unknown reason.              copy of the file being emulated to ESaSS BV
  7039.                                   or one of the support BBSs.
  7040.  
  7041.      Sorry, the collected         The heuristic cleaning mode of TbClean is
  7042.      information is not suf-      aborted and has not been successful. The
  7043.      ficient to clean file...     only option left is to restore the file
  7044.                                   from a backup or to re-install the program.
  7045.  
  7046.      Collected enough infor-      The emulation of the virus provided TbClean
  7047.      mation to attempt a re-      with all information to disinfect the file.
  7048.      liable clean opera-
  7049.      tion...
  7050. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX A
  7051.  
  7052.  
  7053.      Some DOS error occured.      Some DOS error occured while trying to
  7054.      TbClean aborted!             clean the file. Check that no files are
  7055.                                   read-only or located on a write protected
  7056.                                   disk, and make sure there is a reasonable
  7057.                                   amount of free disk space.
  7058.  
  7059.      The clean attempt seems      It seems that TbClean removed the virus
  7060.      to be successful. Test       from the file. No doubt about the virus: it
  7061.      the file carefully!          is gone. However, take care and test the
  7062.                                   file carefully to see if it works as expec-
  7063.                                   ted.
  7064.  
  7065.      Reconstruction failed.       TbClean tried to reconstruct the original
  7066.      Program might be over-       file with the help of the Anti-Vir.Dat
  7067.      written. Trying emulati-     record. However, the attempt failed. Tb-
  7068.      on...                        Clean is going to emulate the file to try
  7069.                                   to clean it heuristically.
  7070.  
  7071.      Reconstruction succes-       The file has been reconstructed to its
  7072.      sfully completed.            original state with help of the information
  7073.                                   of the Anti-Vir.Dat record. The CRC (check-
  7074.                                   sum) of the original file and the cleaned
  7075.                                   file are completely equal, so the cleaned
  7076.                                   file is almost certain equal to the origi-
  7077.                                   nal file.
  7078.  
  7079.      Staring clean attempt.       TbClean is analyzing the infected file and
  7080.      Analyzing infected fi-       tries to locate the Anti-Vir.Dat record.
  7081.      le...
  7082.  
  7083.  
  7084. TbDriver
  7085.  
  7086.      Another version of Tb-       You started a TbDriver.Exe with another
  7087.      Driver is already resi-      version number or processor type than the
  7088.      dent!                        TbDriver already in memory.
  7089.  
  7090.      Cannot remove TbDriver.      You tried to remove TbDriver from memory,
  7091.      Unload other TSRs first!     but other resident software as loaded after
  7092.                                   TbDriver. Resident software can only be
  7093.                                   removed from memory by unloading them in
  7094.                                   reversed order.
  7095.  
  7096.      LAN support was  already     You tried to use the option 'net' for a
  7097.      installed.                   second time, or TbDriver already enabled
  7098.                                   network support automatically.
  7099.  
  7100.      TbDriver not active.         The resident TBAV utilities need TbDriver,
  7101.      Load TbDriver first!         so you have to load TbDriver first.
  7102.  
  7103.      TbDriver is not <versi-      The version of TbDriver found in memory
  7104.      on>.                         does not match the version number of this
  7105.                                   resident TBAV utility. Make sure you do not
  7106.                                   mix version numbers!
  7107. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX A
  7108.  
  7109.  
  7110.      This version of TbDriver     You are using a processor optimized version
  7111.      requires a <typeID> pro-     of TbDriver which can not be executed by
  7112.      cessor.                      the current processor.
  7113.  
  7114.  
  7115. TbScan
  7116.  
  7117.      Cannot create logfile.       The specified log file path is illegal, the
  7118.                                   disk is full or write protected, or the
  7119.                                   file already exists and cannot be overwrit-
  7120.                                   ten.
  7121.  
  7122.      [Cannot read datafile]       TbScan needs access to its data file to be
  7123.                                   able to tell you the name of the virus. If
  7124.                                   it cannot access the data file it displays
  7125.                                   this message instead of the virus.
  7126.  
  7127.      Command line error.          An invalid or illegal commandline option
  7128.                                   has been specified.
  7129.  
  7130.      No matching executable       The specified path does not exist, is emp-
  7131.      files found.                 ty, or is not an executable file.
  7132.  
  7133.      Sanity check failed!         TbScan detected that its internal checksum
  7134.                                   does not match anymore. TbScan is possibly
  7135.                                   contaminated by a virus. Obtain a clean
  7136.                                   copy of TbScan, copy the program on a write
  7137.                                   protected diskette, boot from that diskette
  7138.                                   and try again!
  7139.  
  7140.  
  7141. TbScanX
  7142.  
  7143.      Data file not found.         TbScanX has not been able to locate the
  7144.                                   data file.
  7145.  
  7146.      Not enough memory.           There is not enough free memory to process
  7147.                                   the data file. Try to enable swapping, or
  7148.                                   if you are already doing so, try another
  7149.                                   swapping mode. See also section IV, chapter
  7150.                                   "Memory requirements".
  7151. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX B
  7152.  
  7153.  
  7154. APPENDIX B. TbScan - Heuristic flag descriptions
  7155.  
  7156.  
  7157.      # - Decryptor code found
  7158.      The file possibly contains a self-decryption routine. Some copy-protec-
  7159.      ted software is encrypted so this warning may appear for some of your
  7160.      files. If, however, this warning appears in combination with, for
  7161.      example, the 'T' warning, there could be a virus involved and TbScan
  7162.      assumes the file is contaminated! Many viruses encrypt themselves and
  7163.      cause this warning to be displayed.
  7164.  
  7165.      ! - Invalid program.
  7166.      Invalid opcode (non-8088 instructions) or out-of-range branch. The
  7167.      program has either an entry point that has been located outside the body
  7168.      of the file, or reveals a chain of 'jumps' that can be traced to a
  7169.      location outside the program file. Another possibility is that the
  7170.      program contains invalid processor instructions. The program being
  7171.      checked is probably damaged, and cannot be executed in most cases.
  7172.      Anyway, TbScan does not take any risk and uses the 'scan' method to scan
  7173.      the file.
  7174.  
  7175.      ? - Inconsistent header.
  7176.      The program being processed has an exe-header that does not reflect the
  7177.      actual program lay-out. The DOS SORT.EXE program will cause this warning
  7178.      to be displayed, because the actual size of the program file is less
  7179.      than reported in the 'size-of-load module' field in the exe-header! Many
  7180.      viruses do not update the exe-header of an EXE file correctly after they
  7181.      have infected the file, so if this warning pops up frequently, it seems
  7182.      you have a problem. You should ignore this warning for the DOS SORT.EXE
  7183.      program. (Hopefully MicroSoft will correct the problem before the next
  7184.      release of DOS).
  7185.  
  7186.      c - No integrity check
  7187.      This warning indicates that no checksum/recovery information has been
  7188.      found about the indicated file. It is highly recommended to use TbSetup
  7189.      in this case to store information of the mentioned file. This info can
  7190.      be used later on for integrity checking and to recover from virus
  7191.      infections.
  7192.  
  7193.      h - Hidden or System file.
  7194.      The file has the 'Hidden' or the 'System' file attribute set. This means
  7195.      that the file is not visible in a DOS directory display but TbScan will
  7196.      scan it anyway. If you don't know the origin and/or purpose of this
  7197.      file, you might be dealing with a 'Trojan Horse' or a 'joke' virus
  7198.      program. Copy such a file onto a diskette; then remove it from it's
  7199.      program environment and check if the program concerned is missing the
  7200.      file. If a program does not miss it, you will have freed some disk
  7201.      space, and maybe you have saved your system from a future disaster in
  7202.      the process.
  7203.  
  7204.      i - Internal overlay.
  7205.      The program being processed has additional data or code behind the load-
  7206.      module as specified in the exe-header of the file. The program might
  7207. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX B
  7208.  
  7209.  
  7210.      have internal overlay(s), or configuration or debug information appended
  7211.      behind the load-module of the EXE file.
  7212.  
  7213.      p - Packed or compressed file.
  7214.      The program has been packed or compressed. There are some utilities that
  7215.      are able to compress a program file, like EXEPACK or PKLITE. If the file
  7216.      was infected after the file had been compressed, TbScan will be able to
  7217.      detect the virus. However, if the file had already been infected before
  7218.      it was compressed, the virus has also been compressed in the process,
  7219.      and a virus scanner might not be able to recognize the virus anymore.
  7220.      Fortunately, this does not happen very often, but you should beware! A
  7221.      new program might look clean, but can turn out to be the carrier of a
  7222.      compressed virus. Other files in your system will then be infected too,
  7223.      and it is these infections that will be clearly visible to virus scan-
  7224.      ners.
  7225.  
  7226.      w - Windows or OS/2 header.
  7227.      The program can be or is intended to be used in a Windows (or OS/2)
  7228.      environment. As yet TbScan does not offer a specialized scanning method
  7229.      for these files. Of course that will change as soon as Windows- or OS/2-
  7230.      specific viruses start occurring.
  7231.  
  7232.      A - Suspicious Memory Allocation
  7233.      The program uses a non-standard way to search for, and/or to allocate
  7234.      memory. A lot of viruses try to hide themselves in memory so they use a
  7235.      non-standard way to allocate this memory. Some programs (high-loaders or
  7236.      diagnostic software) also use non-standard ways to search or allocate
  7237.      memory.
  7238.  
  7239.      B - Back to entry.
  7240.      The program seems to execute some code, and after that it jumps back to
  7241.      the entry-point of the program. Normally this would result in an endless
  7242.      loop, except when the program has also modified some of its instructi-
  7243.      ons. This is quite common behaviour for computer viruses. In combination
  7244.      with any other flag TbScan will report a virus.
  7245.  
  7246.      C - File has been changed
  7247.      This warning can only appear if you used TbSetup to generate the Anti-
  7248.      Vir.Dat files. If this warning appears this means that the file has been
  7249.      changed. If you did not upgrade the software it is very likely that a
  7250.      virus infected the file! Note that TbScan does not display this warning
  7251.      if only some internal configuration area of the file changes. This
  7252.      warning means that code at the program entry point, the entry-point
  7253.      itself and/or the file size have been changed.
  7254.  
  7255.      D - Direct disk access
  7256.      This flag is displayed if the program being processed has instructions
  7257.      near the entry-point to write to a disk directly. It is quite normal
  7258.      that some disk-related utilities cause this flag to be displayed. As
  7259.      usual, if many of your files (which have no business writing directly to
  7260.      the disk) cause this flag to be displayed, your system might be infected
  7261.      by an unknown virus.
  7262. =>   Note that a program that accesses the disk directly does not always have
  7263.      to be marked by the 'D' flag. Only when the direct disk instructions are
  7264. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX B
  7265.  
  7266.  
  7267.      near the program entry point it will be reported by TbScan. If a virus
  7268.      is involved the harmful instructions are always near the entry point,
  7269.      which is the place where TbScan looks for them.
  7270.  
  7271.      E - Flexible Entry-point
  7272.      The program starts with a routine that determines its own location
  7273.      within the program file. This is rather suspicious because sound pro-
  7274.      grams have a fixed entry-point so they do not have to determine this
  7275.      location. For viruses however this is quite common: about 50% of the
  7276.      known viruses cause this flag to be displayed.
  7277.  
  7278.      F - Suspicious file access
  7279.      TbScan has found instruction sequences common to infection schemes used
  7280.      by viruses. This flag will appear with those programs that are able to
  7281.      create or modify existing files.
  7282.  
  7283.      G - Garbage instructions.
  7284.      The program contains code that seems to have no purpose other than
  7285.      encryption or avoiding recognition by virus scanners. In most cases
  7286.      there will not be any other flags since the file is encrypted and the
  7287.      instructions are hidden. In a few cases this flag will appear for
  7288.      'normal' files. These files however are badly designed, which is the
  7289.      reason the 'garbage' flag appears.
  7290.  
  7291.      J - Suspicious jump construct.
  7292.      The program did not start at the program entry point. The code has
  7293.      jumped at least two times before reaching the final start-up code, or
  7294.      the program jumped using an indirect operand. Sound programs should not
  7295.      display this kind of strange behaviour. If many files cause this warning
  7296.      to be displayed, you should investigate your system thoroughly.
  7297.  
  7298.      K - Unusual stack.
  7299.      The EXE file being processed has an odd (instead of even) stack offset
  7300.      or a suspicious stack segment. Many viruses are quite 'buggy' by setting
  7301.      up an illegal stack value.
  7302.  
  7303.      L - program Load trap
  7304.      The program might trap the execution of other software. If the file also
  7305.      causes flag M (memory resident code) to be displayed, it is very likely
  7306.      that the file is a resident program that determines when another program
  7307.      is executed. A lot of viruses trap the program load and use it to infect
  7308.      the program. Some anti-virus utilities also trap the program load.
  7309.  
  7310.      M - Memory resident code.
  7311.      TbScan has found instruction sequences which could cause the program to
  7312.      hook into important interrupts. A lot of TSR (Terminate and Stay Resi-
  7313.      dent) programs will trigger this flag, because hooking into interrupts
  7314.      is part of their usual behaviour. If, however, a lot of non-TSR programs
  7315.      cause this warning flag to appear, you should be suspicious. It is
  7316.      likely that your files have been infected by a virus that remains
  7317.      resident in memory. Note that this warning does not appear with all true
  7318.      TSR programs. Nor can TSR detection in non-TSR programs always be relied
  7319.      upon.
  7320. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX B
  7321.  
  7322.  
  7323.      N - Wrong name extension
  7324.      Name conflict. The program carries the extension .EXE but appears to be
  7325.      an ordinary .COM file, or it has the extension .COM but the internal
  7326.      layout of an .EXE file. A wrong name extension might in some cases
  7327.      indicate a virus, but in most cases it does not.
  7328.  
  7329.      O - code Overwrite.
  7330.      This flag will be displayed if TbScan detects that the program overwri-
  7331.      tes some of its own instructions. However, it does not seem to have a
  7332.      complete (de)cryptor routine.
  7333.  
  7334.      R - Suspicious relocator
  7335.      Flag 'R' refers to a suspicious relocator. A relocator is a sequence of
  7336.      instructions that changes the proportion of CS:IP. It is often used by
  7337.      viruses. Those viruses have to relocate the CS:IP proportion because
  7338.      they have been compiled for a specific location in the executable file;
  7339.      a virus that infects another program can hardly ever use its original
  7340.      location in the file as it is appended to this file. Sound pro-
  7341.      grams'know' their location in the executable file, so they don't have to
  7342.      relocate themselves. On systems that operate normally only a small
  7343.      percentage of the programs should therefore cause this flag to be
  7344.      displayed.
  7345.  
  7346.      S - Search for executables
  7347.      The program searches for *.COM or *.EXE files. This by itself does not
  7348.      indicate a virus, but it is an ingredient of most viruses anyway (they
  7349.      have to search for suitable files to spread themselves).  If accompanied
  7350.      by other flags, TbScan will assume the file is infected by a virus.
  7351.  
  7352.      T - Invalid timestamp.
  7353.      The timestamp of the program is invalid: e.g. the number of seconds in
  7354.      the timestamp is illegal, or the date is illegal or later than the year
  7355.      2000. This is suspicious because many viruses set the timestamp to an
  7356.      illegal value (like 62 seconds) to mark that they already infected the
  7357.      file, preventing themselves from infecting a file for a second time
  7358.      around. It is possible that the program being checked is contaminated
  7359.      with a virus that is still unknown, especially if many files on your
  7360.      system have an invalid timestamp. If only a very few programs have an
  7361.      invalid timestamp you'd better correct it and scan frequently to check
  7362.      that the timestamp of the files remains valid.
  7363.  
  7364.      U - Undocumented system call.
  7365.      The program uses unknown DOS calls or interrupts. These unknown calls
  7366.      can be issued to invoke undocumented DOS features, or to communicate
  7367.      with an unknown driver in memory. Since a lot of viruses use undocumen-
  7368.      ted DOS features, or communicate with memory resident parts of a previ-
  7369.      ously loaded instance of the virus, it is suspicious if a program
  7370.      performs unknown or undocumented communications. Nevertheless, it does
  7371.      not necessarily indicate a virus, since some 'tricky' programs use
  7372.      undocumented features also. 
  7373. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX B
  7374.  
  7375.  
  7376.      V - Validated program
  7377.      The program has been validated to avoid false alarms.
  7378.      -    The design of this program would normally cause a false       alarm
  7379.           by the heuristic scan mode of TbScan, or:
  7380.      -    This program might change frequently, and the file is excluded from
  7381.           integrity checking.
  7382.      These exclusions are stored in the Anti-Vir.Dat file by either TbSetup
  7383.      (automatically) or by TbScan (manually).
  7384.  
  7385.      Y - Invalid bootsector.
  7386.      The bootsector is not completely in accordance with the IBM defined
  7387.      bootsector format. It is possible that the bootsector contains a virus
  7388.      or has been corrupted.
  7389.  
  7390.      Z - EXE/COM determinator.
  7391.      The program seems to check whether a file is a COM or EXE type program.
  7392.      Infecting a COM file is a process that is not similar to infecting an
  7393.      EXE file, which implies that viruses able to infect both program types
  7394.      should also be able to distinguish between them. There are of course
  7395.      also innocent programs that need to find out whether a file is a COM or
  7396.      EXE file. Executable file compressors, EXE2COM converters, debuggers,
  7397.      and high-loaders are examples of programs that may contain a routine to
  7398.      distinguish between EXE and COM files.
  7399. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX C
  7400.  
  7401.  
  7402. APPENDIX C. Solving incompatibility problems
  7403.  
  7404.  
  7405.      Although TBAV utilities have been designed to cooperate with other
  7406.      resident software, other software may not, causing system errors or
  7407.      worse.
  7408.  
  7409.  
  7410.  
  7411.      Problem:  If any TBAV utility tries to display a message, the text
  7412.                'message file <filename> could not be opened' appears.
  7413.  
  7414.      Solution: Specify the FULL path and filename of the file you will use as
  7415.                message file after the TbDriver loading command. The default
  7416.                file name is "TbDriver.Lng".
  7417.  
  7418.  
  7419.  
  7420.      Problem:  You are running a network. 
  7421.  
  7422.                TbScanX is installed succesfully, but it does not display the
  7423.                "*scanning*" message while accessing files. It does not detect
  7424.                viruses either.
  7425.  
  7426.                TbCheck is installed succesfully, but it does not display the
  7427.                "*checking*" message while accessing files. It does not detect
  7428.                viruses either. 
  7429.  
  7430.                TbFile is installed succesfully, but it does not detect anyt-
  7431.                hing anymore.
  7432.  
  7433.                TbMem is installed succesfully, but it does not detect TSRs
  7434.                anymore.
  7435.  
  7436.      Solution: Use the command 'TbDriver net' after the network has been
  7437.                loaded.
  7438.  
  7439.  
  7440.  
  7441.      Problem:  The system sometimes hangs when the message "*scanning*" or
  7442.                "*checking*" is on the screen. The problem however is hard to
  7443.                reproduce. The system sometimes hangs when you answer 'NO'(do
  7444.                NOT abort program) to a TbMem, TbFile or TbDisk message. 
  7445.  
  7446.      Solution: Try using StackMan. StackMan is supplied in the TBAV package.
  7447.  
  7448.           TbScanX: if StackMan doesn't help, try TbScanX without option 'EMS'
  7449.           or 'XMS'. If TbScanX now works without any problems, add option
  7450.           'EMS' or 'XMS' again along with option 'compat'. On some systems
  7451.           the TbScanX 'XMS' option cannot be used at all, because these
  7452.           systems do not allow the use of extended memory by resident softwa-
  7453.           re.
  7454. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX C
  7455.  
  7456.  
  7457.      Problem:  It is impossible to start a specific TSR after TbScanX has
  7458.                been loaded. The TSR reports that it already has been loaded
  7459.                in memory, which is not true.
  7460.  
  7461.      Solution: Use the 'compat' switch of TbScanX while loading it. The TSR
  7462.                and TbScanX are using the same multiplex interrupt call.
  7463.  
  7464.  
  7465.  
  7466.      Problem:  Everything works well, but as soon as you load a specific TSR
  7467.                the system hangs immediately after the TSR becomes resident.
  7468.                The TbScanX option 'compat' does not solve the problem.
  7469.  
  7470.      Solution: Use StackMan with the -dos option and try again.
  7471.  
  7472.  
  7473.  
  7474.      Problem:  After you have given permission for a program to remain resi-
  7475.                dent in memory, TbMem asks the same question the next time.
  7476.  
  7477.      Solution: 1)   The 'secure' option of TbDriver is specified. Remove this
  7478.                     option, reboot and try again.
  7479.  
  7480.                2)   The program mentioned does not appear in the Anti-Vir.Dat
  7481.                     file and therefore TbMem cannot permanently store the
  7482.                     permission flag. Use TbSetup to generate the Anti-Vir.Dat
  7483.                     record of this program!
  7484.  
  7485.  
  7486.  
  7487.      Problem:  The system sometimes hangs when you answer 'YES' (abort pro-
  7488.                gram) to a TbMem message.
  7489.  
  7490.      Solution: None. Some resident programs deeply interfere with the system,
  7491.                and once they are rejected from memory the state of the system
  7492.                is not stable anymore.
  7493.  
  7494.  
  7495.  
  7496.      Problem:  When you load TbDisk from the DOS command prompt every-thing
  7497.                works OK. However, when you install TbDisk from within the
  7498.                Config.Sys or AutoExec.Bat file it keeps on warning that
  7499.                programs write to disk directly.
  7500.  
  7501.      Solution: Load TbDisk at the end of your AutoExec.Bat file.
  7502.  
  7503.  
  7504.  
  7505.      Problem:  You formatted the hard disk using DOS FORMAT.COM, but TbDisk
  7506.                did not come up with a message until the process was almost
  7507.                finished.
  7508.  
  7509.      Solution: This is not a problem. A high level format program like DOS
  7510.                FORMAT.COM does actually not format the disk, but it reads all
  7511. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX C
  7512.  
  7513.  
  7514.                tracks to locate possible bad spots, and finally it clears the
  7515.                FAT and directory structure. Only this last step implies a
  7516.                disk write, so only this last step is detected by TbDisk.
  7517.  
  7518.  
  7519.  
  7520.      Problem:  After you have given permission for a program to perform
  7521.                direct disk access, TbDisk asks the same question next time.
  7522.  
  7523.      Solution: 1)   The 'secure' option of TbDriver is specified.  Remove
  7524.                     this option, reboot and try again. 
  7525.  
  7526.                2)   The program mentioned does not appear in the Anti-Vir.Dat
  7527.                     file and therefore TbDisk can not permanently store the
  7528.                     permission flag. Use TbSetup to generate the Anti-Vir.Dat
  7529.                     record ofthis program!
  7530.  
  7531.  
  7532.  
  7533.      Problem:  If you try to use Windows fast 32 bit disk access, Windows
  7534.                comes up with an error message.
  7535.  
  7536.      Solution: Use option 'win32' on the TbDisk command line.
  7537. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX D
  7538.  
  7539.  
  7540. Appendix D. Exit codes
  7541.  
  7542.  
  7543.      TbScan terminates with one of the following exit codes:
  7544.  
  7545.      Errorlevel      0        No viruses found / No error occurred
  7546.                      1        No files found
  7547.                      2        Error occurred
  7548.                      3        Files have been changed
  7549.                      4        Virus found by heuristic analysis
  7550.                      5        Virus found by signature scanning
  7551.                    255        Sanity check failed
  7552.  
  7553.  
  7554.      TbUtil terminates with one of the following exit codes:
  7555.  
  7556.      Errorlevel      0        No error occurred
  7557.                      1        When option 'compare' fails or an error occurs
  7558.  
  7559.  
  7560.      All other ultilities exit with one of the following exit codes:
  7561.  
  7562.      Errorlevel      0        No error occurred
  7563.                      1        Error occurred
  7564. TBAV user manual (C) Copyright 1993 Thunderbyte B.V.                APPENDIX E
  7565.  
  7566.  
  7567. Appendix E. Virus naming
  7568.  
  7569.  
  7570.      How many viruses does TbScan detect?
  7571.  
  7572.      Most of the TbScan signatures are family signatures: one signature
  7573.      detects a whole set of viruses. All these viruses are related to each
  7574.      other. The Jerusalem signature for instance covers more than 100 viru-
  7575.      ses. For this reason one cannot tell how many viruses TbScan detects.
  7576.      Some competitive products treat each virus mutant as a separate virus,
  7577.      thus claiming to detect over 2000 viruses. TbScan, however can detect
  7578.      viruses using 'only' 1000 signatures. If you want to compare virus
  7579.      scanners, you have to rely on the tests frequently published in magazi-
  7580.      nes.
  7581.  
  7582.  
  7583.      The virus naming convention
  7584.  
  7585.      TbScan follows the CARO virus naming recommendations. CARO is an organi-
  7586.      sation in which leading anti-virus researchers participate. Viruses are
  7587.      grouped in a hierarchical tree, which indicates to which family viruses
  7588.      belong. TbScan shows the complete CARO name where possible. Many other
  7589.      anti-virus products however just show the family name or the member
  7590.      name. For instance, the 'Leprosy.Seneca.493' virus might be indicated by
  7591.      the familiy name 'Leprosy' or member name 'Seneca', or even by the
  7592.      variant name '493'. 
  7593.  
  7594.      Anti-virus products developed by non CARO members might even use a
  7595.      completely different name. TbScan however tries to display as much of
  7596.      the name as possible. If TbScan is not able to distinguish between the
  7597.      'Leprosy.Seneca.493' and 'Leprosy.Seneca.517' viruses, both viruses are
  7598.      indicated by the name 'Leprosy.Seneca'.
  7599.  
  7600.      Some viruses mutate themselves frequently. To detect all instances of
  7601.      such a virus it is sometimes necessary to use multiple signatures.
  7602.      Although these signatures cover exactly the same virus, they do have a
  7603.      slightly different indication. Behind the name of the virus you will see
  7604.      a number between anglebrackets. This number however has nothing to do
  7605.      with the name of the virus, but is there just for maintenance reasons.
  7606.